home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / edit / thedjg20.zip / the.man < prev    next >
Text File  |  1995-01-26  |  170KB  |  5,868 lines
  1.                            THE - The Hessling Editor
  2.      
  3.      OVERVIEW
  4.      ========
  5.      
  6.      THE is a text editor that uses both command line commands and key bindings
  7.      to operate. It is intended to be similar to the VM/CMS System Product 
  8.      Editor, XEDIT and to Mansfield Software's, KEDIT.
  9.      
  10.      The screen display consists of several windows:
  11.         - a main body window which displays the contents of the file being
  12.           editted,
  13.         - a command line from which commands may be issued,
  14.         - an optional prefix window which shows line numbers and from
  15.           which prefix commands can be issued
  16.         - an id window which displays the file name, row/col etc. for the
  17.           current file and
  18.         - a status line which indicates global status info like number of files
  19.           being editted, time etc.
  20.      
  21.      An important distinction must be made between what is called the current
  22.      line and the focus line. The focus line is that line in the main body in
  23.      which the cursor is displayed. All commands bound to function keys use the
  24.      focus line as the initial line from which to begin executing the command.
  25.      Commands issued from the command line use the current line as the starting
  26.      line for execution of commands. The current line is the line in the main
  27.      body that is highlighted; by default line 7.
  28.      
  29.      To move between the command line and the main body the 'cursor home' 
  30.      command is used. By default it is bound to the Home key (on PCs), the 
  31.      Do key (on vt220s) and Home (on xterms). 
  32.      
  33.      To determine what keys are bound to what commands, type 'show' followed 
  34.      by Return on the command line, then follow the directions displayed.
  35.      Key bindings may be changed for the current session by using the 'define'
  36.      command.
  37.      
  38.      It is possible to make THE look and behave like either XEDIT or KEDIT.
  39.      See the [SET] COMPAT command for further information.
  40.      
  41.      PROFILE FILE
  42.      ============
  43.      
  44.      Various session defaults may be changed on startup for an individual by
  45.      using a profile file. This file contains various commands that set the
  46.      current environment, including key bindings. This profile file can also be
  47.      used to process commands in batch mode. For example, to change all
  48.      occurrences of 'alligator' to 'crocodile' in the file file.ext in batch
  49.      mode, a profile file (prf.prf) with the following commands would be used:
  50.      
  51.           'c/alligator/crocodile/ * *'
  52.           'file'
  53.      
  54.      and the command
  55.      
  56.           the -p prf.prf file.ext
  57.      
  58.      would be issued.
  59.      
  60.      This changes the first string enclosed in delimiters (either /,\ or @) to
  61.      the second string for every line (*) starting at the current line
  62.      (0 initially) changing each occurrence on a line (*).
  63.      Maybe you only want to change a string after the first line that contains
  64.      the string 'donkey', but only change the second occurrence of that string.
  65.      The profile commands would then be:
  66.      
  67.           '/donkey/'
  68.           'c/alligator/crocodile/ * 1 2'
  69.           'file'
  70.      
  71.      The change command uses a 'target' specification as its first parameter
  72.      after the string details. A target can be a number of lines, an absolute
  73.      line number, BLANK, ALL or a string.
  74.      Number of line targets consist of either a positive integer, for
  75.      referencing lines toward the end of the file, negative for referencing
  76.      toward the start of the file or '*', which is all the remaining lines in
  77.      the file or '-*' which is all lines toward the start of the file.
  78.      An absolute line number in the form of ':n' is the line number in a file,
  79.      starting with line number 1.
  80.      A target is any string within the allowable target delimiters.
  81.      
  82.      For more information on default key bindings see the *.hlp files. Detailed
  83.      documentation of each command is present in each of the comm*.c files.
  84.      
  85.      --------------------------------------------------------------------------
  86.      
  87.      
  88.      ========================================================================
  89.      COMMAND REFERENCE
  90.      ========================================================================
  91.  
  92.  
  93.  
  94.      --------------------------------------------------------------------------
  95.      COMMAND
  96.           add - add blank line
  97.      
  98.      SYNTAX
  99.           Add [n]
  100.      
  101.      DESCRIPTION
  102.           The ADD command inserts the specified number of blank lines after
  103.           the current_line (if issued from the command line) or after the
  104.           focus_line (if issued from the FILEAREA or PREFIX areas).
  105.           If SET NEWLINE is set to ALIGNED, the cursor is positioned in
  106.           the column corresponding to the first column not containing a 
  107.           space in the line above.
  108.           If SET NEWLINE is set to LEFT, the cursor is positioned in the
  109.           first column.
  110.      
  111.      COMPATIBILITY
  112.           XEDIT: Compatible.
  113.           KEDIT: Compatible.
  114.      
  115.      DEFAULT
  116.           1
  117.      
  118.      SEE ALSO
  119.           SOS ADDLINE
  120.      
  121.      STATUS
  122.           Complete
  123.  
  124.  
  125.  
  126.      --------------------------------------------------------------------------
  127.      COMMAND
  128.           all - select and display restricted set of lines
  129.      
  130.      SYNTAX
  131.           ALL [rtarget]
  132.      
  133.      DESCRIPTION
  134.           The ALL command allows for the selective display, and editting
  135.           (subject to SET SCOPE) of lines that match the specified target.
  136.           This target consists of any number of individual targets
  137.           seperated by '&' (logical and) or '|' (logical or). 
  138.           For example, to display all lines in a file that contain the 
  139.           strings 'ball' and 'cat' on the same line or the named lines 
  140.           .fred or .bill, use the following command:
  141.      
  142.           ALL /ball/ & /cat/ | .fred | .bill
  143.      
  144.           Logical operators act left to right, with no precedence for &.
  145.      
  146.           ALL without any arguments, displays all lines in the file.
  147.      
  148.      COMPATIBILITY
  149.           XEDIT: Compatible.
  150.           KEDIT: Compatible.
  151.      
  152.      SEE ALSO
  153.           SET SCOPE, SET DISPLAY, SET SELECT
  154.      
  155.      STATUS
  156.           Complete.
  157.  
  158.  
  159.  
  160.      --------------------------------------------------------------------------
  161.      COMMAND
  162.           backward - scroll backwards [n] screens
  163.      
  164.      SYNTAX
  165.           BAckward [n|*]
  166.      
  167.      DESCRIPTION
  168.           The BACKWARD command scrolls the file contents backwards through
  169.           the file [n|*] screens.
  170.      
  171.           If 0 is specified as the number of screens to scroll, the last
  172.           line of the file becomes the current line. 
  173.           If the BACKWARD command is issued while the current line is
  174.           the "Top of File" line, the last line of the file becomes the 
  175.           current line.
  176.      
  177.      COMPATIBILITY
  178.           XEDIT: Compatible.
  179.           KEDIT: Does not support HALF or Lines options.
  180.      
  181.      DEFAULT
  182.           1
  183.      
  184.      SEE ALSO
  185.           FORWARD, TOP
  186.      
  187.      STATUS
  188.           Complete
  189.  
  190.  
  191.  
  192.      --------------------------------------------------------------------------
  193.      COMMAND
  194.           bottom - move to the bottom of the file
  195.      
  196.      SYNTAX
  197.           BOTtom
  198.      
  199.      DESCRIPTION
  200.           The BOTTOM command moves to the very end of the current file.
  201.           The last line of the file is set to the current line.
  202.      
  203.      COMPATIBILITY
  204.           XEDIT: Compatible.
  205.           KEDIT: Compatible.
  206.      
  207.      SEE ALSO
  208.           FORWARD, TOP
  209.      
  210.      STATUS
  211.           Complete
  212.  
  213.  
  214.  
  215.      --------------------------------------------------------------------------
  216.      COMMAND
  217.           cancel - quit from all unaltered files in the ring
  218.      
  219.      SYNTAX
  220.           CANcel
  221.      
  222.      DESCRIPTION
  223.           The CANCEL command exits from THE quickly by executing a QQUIT
  224.           command for every file in the ring that does not have any 
  225.           outstanding alterations.
  226.      
  227.      COMPATIBILITY
  228.           XEDIT: Compatible.
  229.           KEDIT: Compatible.
  230.      
  231.      SEE ALSO
  232.           CCANCEL
  233.      
  234.      STATUS
  235.           Complete.
  236.  
  237.  
  238.  
  239.      --------------------------------------------------------------------------
  240.      COMMAND
  241.           ccancel - qquit from all files in the ring
  242.      
  243.      SYNTAX
  244.           CCancel
  245.      
  246.      DESCRIPTION
  247.           The CCANCEL command exits from THE quickly by executing the QQUIT
  248.           command for every file in the ring. Any changes made to any of 
  249.           the files will be lost.
  250.      
  251.      COMPATIBILITY
  252.           XEDIT: N/A
  253.           KEDIT: N/A
  254.      
  255.      SEE ALSO
  256.           CANCEL
  257.      
  258.      STATUS
  259.           Complete.
  260.  
  261.  
  262.  
  263.      --------------------------------------------------------------------------
  264.      COMMAND
  265.           change - change one string to another
  266.      
  267.      SYNTAX
  268.           Change /string1/string2/ [target] [n] [m]
  269.      
  270.      DESCRIPTION
  271.           The CHANGE command changes one string of text to another.
  272.      
  273.           The first parameter to the change command is the old and new
  274.           string values, seperated by delimiters.
  275.           The allowable delimiters are '/' '\' and '@'.
  276.      
  277.           The second parameter is the target; how many lines are to be
  278.           searched for occurrences of the first string to be changed.
  279.      
  280.           The third parameter determines how many occurrences of 'string1'
  281.           are to be changed on each line.
  282.      
  283.           The fourth parameter determines at which occurrences of 'string1'
  284.           on the line are changes to commence.
  285.      
  286.      COMPATIBILITY
  287.           XEDIT: Compatible.
  288.           KEDIT: Compatible.
  289.      
  290.      DEFAULT
  291.           1 1 1
  292.      
  293.      SEE ALSO
  294.           SCHANGE
  295.      
  296.      STATUS
  297.           Complete.
  298.  
  299.  
  300.  
  301.      --------------------------------------------------------------------------
  302.      COMMAND
  303.           cmatch - find matching bracket character
  304.      
  305.      SYNTAX
  306.           cmatch 
  307.      
  308.      DESCRIPTION
  309.           The CMATCH command searches for the matching bracket character to
  310.           the character under the cursor.
  311.      
  312.           It handles nested sets of matching pairs.
  313.           The matching character pairs are '[]{}<>()'.
  314.      
  315.           This command can only be used by assigning it to a function key
  316.           with the DEFINE command.
  317.      
  318.      COMPATIBILITY
  319.           XEDIT: N/A
  320.           KEDIT: Compatible.
  321.      
  322.      STATUS
  323.           Complete.
  324.  
  325.  
  326.  
  327.      --------------------------------------------------------------------------
  328.      COMMAND
  329.           cmsg - display text on command line
  330.      
  331.      SYNTAX
  332.           CMSG [text]
  333.      
  334.      DESCRIPTION
  335.           The CMSG command, primarily used in macros, displays text on the
  336.           command line.
  337.      
  338.      COMPATIBILITY
  339.           XEDIT: Compatible.
  340.           KEDIT: Compatible.
  341.      
  342.      SEE ALSO
  343.           EMSG, MSG
  344.      
  345.      STATUS
  346.           Complete.
  347.  
  348.  
  349.  
  350.      --------------------------------------------------------------------------
  351.      COMMAND
  352.           command - execute a command without translation
  353.      
  354.      SYNTAX
  355.           COMMAND command [options]
  356.      
  357.      DESCRIPTION
  358.           The COMMAND command executes the specified command without
  359.           synonym or macro translation. THE does not attempt to execute 
  360.           the command as a macro even if IMPMACRO is ON. The command will 
  361.           be passed to the operating system if IMPOS is ON.
  362.      
  363.      COMPATIBILITY
  364.           XEDIT: Compatible.
  365.           KEDIT: Compatible.
  366.      
  367.      STATUS
  368.           Complete.
  369.  
  370.  
  371.  
  372.      --------------------------------------------------------------------------
  373.      COMMAND
  374.           control_char - allow control characters to be entered
  375.      
  376.      SYNTAX
  377.           control_char
  378.      
  379.      DESCRIPTION
  380.           The CONTROL_CHAR command prompts the user to enter a control 
  381.           character.
  382.      
  383.           This command can only be used by assigning it to a function key
  384.           with the DEFINE command.
  385.      
  386.      COMPATIBILITY
  387.           XEDIT: N/A
  388.           KEDIT: N/A
  389.      
  390.      STATUS
  391.           Complete.
  392.  
  393.  
  394.  
  395.      --------------------------------------------------------------------------
  396.      COMMAND
  397.           copy - copies text from one position to another
  398.      
  399.      SYNTAX
  400.           COPY target1 target2
  401.           COPY BLOCK [RESET]
  402.      
  403.      DESCRIPTION
  404.           With the first form of the COPY command, text is copied from the
  405.           first target area to the line specified by target2. Text can
  406.           only be copied within the same view of the file.
  407.      
  408.           The second form of the COPY command copies text within the
  409.           currently marked block to the current cursor position.
  410.           The text can be in the same file or a different file.
  411.      
  412.      COMPATIBILITY
  413.           XEDIT: COPY BLOCK not available.
  414.           KEDIT: Adds extra functionality with [RESET] option.
  415.                  With the cursor in the marked block this command in KEDIT
  416.                  acts like DUPLICATE BLOCK.
  417.      
  418.      STATUS
  419.           Complete.
  420.  
  421.  
  422.  
  423.      --------------------------------------------------------------------------
  424.      COMMAND
  425.           cursor - move cursor to specified position
  426.      
  427.      SYNTAX
  428.           CURsor Screen UP|DOWN|LEFT|RIGHT
  429.           CURsor Screen row [col]
  430.           CURsor [Escreen] UP|DOWN
  431.           CURsor [Escreen|Kedit] LEFT|RIGHT
  432.           CURsor [Escreen] row [col]
  433.           CURsor CMdline [n]
  434.           CURsor HOME [SAVE]
  435.      
  436.      DESCRIPTION
  437.           The CURSOR command allows the user to specify where the cursor
  438.           is to be positioned.
  439.      
  440.           CURSOR SCREEN UP|DOWN|LEFT|RIGHT moves the cursor in the
  441.           indicated direction one line or column. If the cursor is
  442.           positioned on the first or last line of the screen, the cursor
  443.           wraps to the first or last enterable lines. If the cursor is
  444.           positioned on the left or right edges of the screen, the cursor
  445.           moves to the left or right edge of the screen on the same line.
  446.      
  447.           CURSOR SCREEN row [col] moves the cursor to the specified
  448.           row/col position within the file area. The top left corner of
  449.           the file area is 1,1.
  450.           row and col may be specified as '=', which will default to the
  451.           current row and/or column position.
  452.           If row or col are greater than the maximum number of rows or
  453.           columns in the file area, the cursor will move to the last 
  454.           row/column available.
  455.           If the specified row is a reserved line, scale line or tab line
  456.           an error will be displayed.
  457.           If the row specified is above "Top of File" or below
  458.           "Bottom of File" the cursor will be placed on the appropriate
  459.           line.
  460.      
  461.           CURSOR [ESCREEN] UP|DOWN|LEFT|RIGHT is similar to CURSOR SCREEN
  462.           UP|DOWN|LEFT|RIGHT, except that where scrolling of the window is
  463.           possible, then scrolling will take place.
  464.      
  465.           CURSOR [ESCREEN] row [col] is similar to CURSOR SCREEN row [col],
  466.           but all coordinates are relative the the top left corner of the
  467.           logical window, not the top left corner of the file area. Hence,
  468.           1,1 would be an invalid cursor position because it would result
  469.           in the cursor being moved to the id line.
  470.           Specification of row and/or column outside the boundaries of the
  471.           logical window is regarded as an error.
  472.      
  473.           CURSOR KEDIT LEFT|RIGHT mimics the default behaviour of CURL and
  474.           CURR in KEDIT.
  475.      
  476.           CURSOR CMDMLINE moves the cursor to the indicated column of the
  477.           command line.
  478.      
  479.           CURsor HOME moves the cursor to the first column of the command
  480.           line (if not on the command line), or to the last row/column of
  481.           the file area if on the command line. With the [SAVE] option,
  482.           the cursor will move to the last row/column of the file area or
  483.           prefix area (which ever was the last position) if on the
  484.           command line.
  485.      
  486.      
  487.      COMPATIBILITY
  488.           XEDIT: Does not support COLUMN or FILE options.
  489.           KEDIT: Does not support COLUMN or FILE options.
  490.      
  491.      STATUS
  492.           Complete.
  493.  
  494.  
  495.  
  496.      --------------------------------------------------------------------------
  497.      COMMAND
  498.           define - assign one or many commands to a key
  499.      
  500.      SYNTAX
  501.           DEFine key-name [command [args] [[#command [args]...]]]
  502.      
  503.      DESCRIPTION
  504.           The DEFINE command allows the user to assign one or many 
  505.           commands and optional parameter(s) to a key. 
  506.      
  507.           Commands may be abbreviated.
  508.      
  509.           If multiple commands are assigned, then the LINEND setting
  510.           must be ON and the LINEND character must match the character
  511.           that delimits the commands at the time that the DEFINE command
  512.           is executed. LINEND can be OFF at the time the key is pressed.
  513.      
  514.           With no arguments, any existing definition for that key is
  515.           removed and the key reverts back to its default assignation (if
  516.           it had any).
  517.      
  518.           key-names correspond to the key name shown with the SHOW command.
  519.      
  520.      COMPATIBILITY
  521.           XEDIT: N/A
  522.           KEDIT: Minimal. No support for in-memory macro commands.
  523.                  KEDIT does not allow multiple commands except as KEXX
  524.                  macros.
  525.      
  526.      SEE ALSO
  527.           SHOW
  528.      
  529.      STATUS
  530.           Complete.
  531.  
  532.  
  533.  
  534.      --------------------------------------------------------------------------
  535.      COMMAND
  536.           delete - delete lines from a file
  537.      
  538.      SYNTAX
  539.           DELete [target]
  540.      
  541.      DESCRIPTION
  542.           The DELETE command removes lines from the current file.
  543.           The number of lines removed depends on the target specified.
  544.           Lines are removed starting with the focus line.
  545.      
  546.      COMPATIBILITY
  547.           XEDIT: Compatible.
  548.           KEDIT: Compatible.
  549.      
  550.      DEFAULT
  551.           1
  552.      
  553.      SEE ALSO
  554.           SOS DELLINE
  555.      
  556.      STATUS
  557.           Complete.
  558.  
  559.  
  560.  
  561.      --------------------------------------------------------------------------
  562.      COMMAND
  563.           directory - list the specified directory as an editable file
  564.      
  565.      SYNTAX
  566.           DIRectory [filespec]
  567.      
  568.      DESCRIPTION
  569.           The DIRECTORY command displays all files matching the specified 
  570.           file specification.
  571.           When no parameter is supplied, all files in the current directory 
  572.           are displayed subject to any SET DIRINCLUDE restrictions.
  573.      
  574.      COMPATIBILITY
  575.           XEDIT: N/A
  576.           KEDIT: Compatible.
  577.      
  578.      SEE ALSO
  579.           LS, SET DIRINCLUDE
  580.      
  581.      STATUS
  582.           Complete.
  583.  
  584.  
  585.  
  586.      --------------------------------------------------------------------------
  587.      COMMAND
  588.           dos - execute an operating system command
  589.      
  590.      SYNTAX
  591.           DOS [command]
  592.      
  593.      DESCRIPTION
  594.           The DOS command executes the supplied operating system command 
  595.           or runs an interactive shell if no command is supplied.
  596.      
  597.      COMPATIBILITY
  598.           XEDIT: N/A
  599.           KEDIT: Compatible.
  600.      
  601.      SEE ALSO
  602.           OS, !
  603.      
  604.      STATUS
  605.           Complete.
  606.  
  607.  
  608.  
  609.      --------------------------------------------------------------------------
  610.      COMMAND
  611.           dosnowait - execute an operating system command - no prompt
  612.      
  613.      SYNTAX
  614.           DOSNowait command
  615.      
  616.      DESCRIPTION
  617.           The DOSNOWAIT command executes the supplied operating system 
  618.           command not waiting for the user to be prompted once the
  619.           command has completed.
  620.      
  621.      COMPATIBILITY
  622.           XEDIT: N/A
  623.           KEDIT: Compatible.
  624.      
  625.      SEE ALSO
  626.           OSNOWAIT
  627.      
  628.      STATUS
  629.           Complete.
  630.  
  631.  
  632.  
  633.      --------------------------------------------------------------------------
  634.      COMMAND
  635.           dosquiet - execute an operating system command quietly
  636.      
  637.      SYNTAX
  638.           DOSQuiet command
  639.      
  640.      DESCRIPTION
  641.           The OSQUIET command executes the supplied operating system command 
  642.           as quietly as possible.
  643.      
  644.      COMPATIBILITY
  645.           XEDIT: N/A
  646.           KEDIT: Compatible.
  647.      
  648.      SEE ALSO
  649.           OSQUIET
  650.      
  651.      STATUS
  652.           Complete.
  653.  
  654.  
  655.  
  656.      --------------------------------------------------------------------------
  657.      COMMAND
  658.           down - move forward in the file a number of lines
  659.      
  660.      SYNTAX
  661.           Down [relative_target]
  662.      
  663.      DESCRIPTION
  664.           The DOWN command moves the current line forwards the number of
  665.           lines specified by the relative_target. This relative_target can 
  666.           only be a positive integer or the character "*". 
  667.      
  668.      COMPATIBILITY
  669.           XEDIT: Compatible.
  670.           KEDIT: Compatible.
  671.      
  672.      DEFAULT
  673.           1
  674.      
  675.      SEE ALSO
  676.           NEXT, UP
  677.      
  678.      STATUS
  679.           Complete.
  680.  
  681.  
  682.  
  683.      --------------------------------------------------------------------------
  684.      COMMAND
  685.           duplicate - duplicate lines
  686.      
  687.      SYNTAX
  688.           DUPlicate [n [target|BLOCK]]
  689.      
  690.      DESCRIPTION
  691.           The DUPLICATE command copies the number of lines extrapolated from
  692.           target, n times.
  693.      
  694.      COMPATIBILITY
  695.           XEDIT: Equivalent of DUPLICAT command.
  696.           KEDIT: Compatible.
  697.      
  698.      STATUS
  699.           Complete.
  700.  
  701.  
  702.  
  703.      --------------------------------------------------------------------------
  704.      COMMAND
  705.           edit - edit another file or switch to next file
  706.      
  707.      SYNTAX
  708.           Edit [filename]
  709.      
  710.      DESCRIPTION
  711.           The EDIT command allows the user to edit another file. The new file
  712.           is placed in the file ring. The previous file being edited remains
  713.           in memory and can be returned to by issuing an EDIT command without
  714.           any parameters. Several files can be edited at once, and all files
  715.           are arranged in a ring, with subsequent EDIT commands moving through
  716.           the ring, one file at a time.
  717.      
  718.      COMPATIBILITY
  719.           XEDIT: Does not provide options switches.
  720.           KEDIT: Does not provide options switches.
  721.      
  722.      SEE ALSO
  723.           THE, XEDIT
  724.      
  725.      STATUS
  726.           Complete.
  727.  
  728.  
  729.  
  730.      --------------------------------------------------------------------------
  731.      COMMAND
  732.           emsg - display message
  733.      
  734.      SYNTAX
  735.           EMSG [message]
  736.      
  737.      DESCRIPTION
  738.           The EMSG command displays an error message on the error line.
  739.           This command is usually issued from a macro file.
  740.      
  741.      COMPATIBILITY
  742.           XEDIT: Does not support [mmmnnns text] option
  743.           KEDIT: Compatible
  744.      
  745.      SEE ALSO
  746.           CMSG, MSG
  747.      
  748.      STATUS
  749.           Complete.
  750.  
  751.  
  752.  
  753.      --------------------------------------------------------------------------
  754.      COMMAND
  755.           enter - execute a command
  756.      
  757.      SYNTAX
  758.           enter
  759.      
  760.      DESCRIPTION
  761.           The ENTER command executes the command currently displayed on the
  762.           command line, if the cursor is currently displayed there.
  763.           If the key associated with ENTER is pressed while in the FILEAREA,
  764.           then the cursor will move to the first column of the
  765.           next line. If the cursor is in the PREFIX area, any pending 
  766.           prefix commands will be executed. If the mode is currently in 
  767.           'insert', then a new line is added and the cursor placed on the
  768.           next line depending on the value of SET NEWLINE.
  769.      
  770.           This command can only be used by assigning it to a function key
  771.           with the DEFINE command.
  772.      
  773.           This command will be removed in a future version.
  774.      
  775.      COMPATIBILITY
  776.           XEDIT: N/A
  777.           KEDIT: N/A
  778.      
  779.      SEE ALSO
  780.           SOS EXECUTE
  781.      
  782.      STATUS
  783.           Complete.
  784.  
  785.  
  786.  
  787.      --------------------------------------------------------------------------
  788.      COMMAND
  789.           expand - expand tab characters to spaces
  790.      
  791.      SYNTAX
  792.           EXPand [target]
  793.      
  794.      DESCRIPTION
  795.           The EXPAND command converts all tab characters to spaces depending
  796.           on the size of a tab determined by the SET TABS command.
  797.      
  798.      COMPATIBILITY
  799.           XEDIT: Compatible.
  800.           KEDIT: Compatible.
  801.      
  802.      SEE ALSO
  803.           SET TABS
  804.      
  805.      STATUS
  806.           Complete.
  807.  
  808.  
  809.  
  810.      --------------------------------------------------------------------------
  811.      COMMAND
  812.           extract - obtain various internal information about THE
  813.      
  814.      SYNTAX
  815.           EXTract /item/[...]
  816.      
  817.      DESCRIPTION
  818.           The EXTRACT command is used to relay information about settings
  819.           within THE from within a REXX macro. EXTRACT is only valid within
  820.           a REXX macro.
  821.      
  822.      COMPATIBILITY
  823.           XEDIT: Only allows '/' as delimiter.
  824.           KEDIT: Only allows '/' as delimiter.
  825.      
  826.      STATUS
  827.           Complete.
  828.  
  829.  
  830.  
  831.      --------------------------------------------------------------------------
  832.      COMMAND
  833.           ffile - force a FILE of the current file to disk
  834.      
  835.      SYNTAX
  836.           FFile  [filename]
  837.      
  838.      DESCRIPTION
  839.           The FFILE command writes the current file to disk to the current
  840.           file name or to the supplied filename.
  841.           Unlike the FILE command, if the optional filename exists, this
  842.           command will overwrite the file.
  843.      
  844.      COMPATIBILITY
  845.           XEDIT: N/A
  846.           KEDIT: Compatible.
  847.      
  848.      DEFAULT
  849.           With no parameters, the current file is written.
  850.      
  851.      SEE ALSO
  852.           FILE, SAVE, SSAVE
  853.      
  854.      STATUS
  855.           Complete
  856.  
  857.  
  858.  
  859.      --------------------------------------------------------------------------
  860.      COMMAND
  861.           file - write the current file to disk and remove from ring
  862.      
  863.      SYNTAX
  864.           FILE  [filename]
  865.      
  866.      DESCRIPTION
  867.           The FILE command writes the current file to disk to the current
  868.           file name or to the supplied filename.
  869.           Unlike the FFILE command, if the optional filename exists, this
  870.           command will not overwrite the file.
  871.      
  872.      COMPATIBILITY
  873.           XEDIT: Compatible.
  874.           KEDIT: Compatible.
  875.      
  876.      DEFAULT
  877.           With no parameters, the current file is written.
  878.      
  879.      SEE ALSO
  880.           FFILE, SAVE, SSAVE
  881.      
  882.      STATUS
  883.           Complete
  884.  
  885.  
  886.  
  887.      --------------------------------------------------------------------------
  888.      COMMAND
  889.           fillbox - fill the marked box block with a character
  890.      
  891.      SYNTAX
  892.           FILLbox [c]
  893.      
  894.      DESCRIPTION
  895.           The FILLBOX command fills the marked block with the specified
  896.           character. If no parameters are supplied and the command is run
  897.           from the command line, then the box will be filled with spaces.
  898.           If the command is not run from the command line, the user is
  899.           prompted for a character to fill the box.
  900.      
  901.      COMPATIBILITY
  902.           XEDIT: N/A
  903.           KEDIT: Compatible.
  904.      
  905.      STATUS
  906.           Complete
  907.  
  908.  
  909.  
  910.      --------------------------------------------------------------------------
  911.      COMMAND
  912.           forward - scroll forwards [n] screens
  913.      
  914.      SYNTAX
  915.           FOrward [n]
  916.      
  917.      DESCRIPTION
  918.           The FORWARD command scrolls the file contents forwards the number
  919.           of screens specified.
  920.      
  921.           If 0 is specified as the number of screens to scroll, the "Top
  922.           of File" line becomes the current line. 
  923.           If the FORWARD command is issued while the current line is the 
  924.           "Bottom of File" line, the "Top of File" line becomes the 
  925.           current line.
  926.      
  927.      COMPATIBILITY
  928.           XEDIT: Compatible.
  929.           KEDIT: Does not support HALF or Lines options.
  930.      
  931.      DEFAULT
  932.           1
  933.      
  934.      SEE ALSO
  935.           BACKWARD, TOP
  936.      
  937.      STATUS
  938.           Complete
  939.  
  940.  
  941.  
  942.      --------------------------------------------------------------------------
  943.      COMMAND
  944.           get - insert into file the contents of specified file
  945.      
  946.      SYNTAX
  947.           GET [fileid]
  948.      
  949.      DESCRIPTION
  950.           The GET command reads a file into the current file, inserting
  951.           lines after the current line.
  952.           When no fileid is supplied the temporary file generated by the
  953.           PUT command is used.
  954.      
  955.      COMPATIBILITY
  956.           XEDIT: Does not support optional firstrec - numrecs
  957.           KEDIT: Does not support optional fromlines - forlines.
  958.      
  959.      SEE ALSO
  960.           PUT, PUTD
  961.      
  962.      STATUS
  963.           Complete
  964.  
  965.  
  966.  
  967.      --------------------------------------------------------------------------
  968.      COMMAND
  969.           help - edit help file for THE
  970.      
  971.      SYNTAX
  972.           HELP
  973.      
  974.      DESCRIPTION
  975.           The HELP command displays help for the editor.
  976.           Uses THE_HELP_FILE environment variable to point to the help file.
  977.      
  978.      COMPATIBILITY
  979.           XEDIT: Similar in concept.
  980.           KEDIT: Similar in concept.
  981.      
  982.      STATUS
  983.           Complete.
  984.  
  985.  
  986.  
  987.      --------------------------------------------------------------------------
  988.      COMMAND
  989.           input - insert the command line contents into the file
  990.      
  991.      SYNTAX
  992.           Input [line contents]
  993.      
  994.      DESCRIPTION
  995.           The INPUT command inserts the remainder of the command line into the
  996.           file after the current line.
  997.      
  998.      COMPATIBILITY
  999.           XEDIT: Does not provide full input mode option.
  1000.           KEDIT: Does not provide full input mode option.
  1001.      
  1002.      STATUS
  1003.           Complete.
  1004.  
  1005.  
  1006.  
  1007.      --------------------------------------------------------------------------
  1008.      COMMAND
  1009.           join - join a line with the line following
  1010.      
  1011.      SYNTAX
  1012.           Join [ALigned]
  1013.      
  1014.      DESCRIPTION
  1015.           The JOIN command makes one line out of the focus line and the
  1016.           line following.
  1017.           If ALIGNED is specified, any leading spaces in the following line
  1018.           are ignored. If ALIGNED is not specified, all characters, including
  1019.           spaces are added.
  1020.      
  1021.      COMPATIBILITY
  1022.           XEDIT: Compatible.
  1023.           KEDIT: Compatible.
  1024.      
  1025.      SEE ALSO
  1026.           SPLIT, SPLTJOIN
  1027.      
  1028.      STATUS
  1029.           Complete.
  1030.  
  1031.  
  1032.  
  1033.      --------------------------------------------------------------------------
  1034.      COMMAND
  1035.           left - scroll the screen to the left
  1036.      
  1037.      SYNTAX
  1038.           LEft [n|HALF]
  1039.      
  1040.      DESCRIPTION
  1041.           The LEFT command scrolls the screen n columns to the left.
  1042.           If no parameter is supplied, the screen is scrolled by one
  1043.           column. If HALF is specified the screen is scrolled by half 
  1044.           the number of columns in the FILEAREA.
  1045.      
  1046.      COMPATIBILITY
  1047.           XEDIT: Compatible.
  1048.           KEDIT: Compatible.
  1049.      
  1050.      SEE ALSO
  1051.           RIGHT, RGTLEFT
  1052.      
  1053.      STATUS
  1054.           Complete.
  1055.  
  1056.  
  1057.  
  1058.      --------------------------------------------------------------------------
  1059.      COMMAND
  1060.           locate - search for a target
  1061.      
  1062.      SYNTAX
  1063.           [Locate] target [command]
  1064.      
  1065.      DESCRIPTION
  1066.           The LOCATE command searches for the next or previous occurrence 
  1067.           of the specified target.  If no parameter is supplied, LOCATE
  1068.           uses the the last target specified. If no prior target has been
  1069.           specified, an error message is displayed. With an optional operand, 
  1070.           it executes the command after finding the target.
  1071.      
  1072.      COMPATIBILITY
  1073.           XEDIT: Compatible.
  1074.           KEDIT: Compatible.
  1075.      
  1076.      STATUS
  1077.           Complete.
  1078.  
  1079.  
  1080.  
  1081.      --------------------------------------------------------------------------
  1082.      COMMAND
  1083.           lowercase - change uppercase characters to lowercase
  1084.      
  1085.      SYNTAX
  1086.           LOWercase [target]
  1087.      
  1088.      DESCRIPTION
  1089.           The LOWERCASE command changes all uppercase characters in all 
  1090.           lines up to the target line to lowercase. All other characters 
  1091.           remain untouched.
  1092.      
  1093.      COMPATIBILITY
  1094.           XEDIT: Equivalent of LOWERCAS command.
  1095.           KEDIT: Compatible.
  1096.      
  1097.      SEE ALSO
  1098.           UPPERCASE
  1099.      
  1100.      STATUS
  1101.           Complete.
  1102.  
  1103.  
  1104.  
  1105.      --------------------------------------------------------------------------
  1106.      COMMAND
  1107.           ls - list the specified directory as an editable file
  1108.      
  1109.      SYNTAX
  1110.           LS [filespec]
  1111.      
  1112.      DESCRIPTION
  1113.           The LS command displays all files matching the specified
  1114.           file specification.
  1115.           When no parameter is supplied, all files in the current directory 
  1116.           are displayed subject to any SET DIRINCLUDE restrictions.
  1117.      
  1118.      COMPATIBILITY
  1119.           XEDIT: N/A
  1120.           KEDIT: Compatible.
  1121.      
  1122.      SEE ALSO
  1123.           DIRECTORY, SET DIRINCLUDE
  1124.      
  1125.      STATUS
  1126.           Complete.
  1127.  
  1128.  
  1129.  
  1130.      --------------------------------------------------------------------------
  1131.      COMMAND
  1132.           macro - execute a macro command file
  1133.      
  1134.      SYNTAX
  1135.           MACRO filename [arguments]
  1136.      
  1137.      DESCRIPTION
  1138.           The MACRO command executes the contents of the specified file
  1139.           as command line commands.
  1140.      
  1141.      COMPATIBILITY
  1142.           XEDIT: Compatible.
  1143.           KEDIT: Compatible.
  1144.           Only REXX macros accept the passing of arguments to the macro file.
  1145.      
  1146.      STATUS
  1147.           Complete.
  1148.  
  1149.  
  1150.  
  1151.      --------------------------------------------------------------------------
  1152.      COMMAND
  1153.           mark - mark a portion of text
  1154.      
  1155.      SYNTAX
  1156.           MARK Line|Box|Stream|Word|Column
  1157.      
  1158.      DESCRIPTION
  1159.           The MARK command marks a portion of text for later processing
  1160.           by a COPY, MOVE or DELETE command.
  1161.      
  1162.      COMPATIBILITY
  1163.           XEDIT: N/A
  1164.           KEDIT: Does not implement Stream.
  1165.                  Adds WORD option and COLUMN options.
  1166.      
  1167.      STATUS
  1168.           Complete.
  1169.  
  1170.  
  1171.  
  1172.      --------------------------------------------------------------------------
  1173.      COMMAND
  1174.           modify - display current SET command for alteration
  1175.      
  1176.      SYNTAX
  1177.           MODify set-command
  1178.      
  1179.      DESCRIPTION
  1180.           The MODIFY command displays the current setting of a set command
  1181.           on the command line enabling the user to change that setting.
  1182.      
  1183.      COMPATIBILITY
  1184.           XEDIT: Compatible.
  1185.           KEDIT: Compatible.
  1186.      
  1187.      SEE ALSO
  1188.           SET, QUERY
  1189.      
  1190.      STATUS
  1191.           Complete.
  1192.  
  1193.  
  1194.  
  1195.      --------------------------------------------------------------------------
  1196.      COMMAND
  1197.           move - move a portion of text
  1198.      
  1199.      SYNTAX
  1200.           MOVE BLOCK [RESET]
  1201.      
  1202.      DESCRIPTION
  1203.           The MOVE command copies the contents of the marked block to the
  1204.           current cursor position and deletes the characters/lines from the
  1205.           original position of the marked block.
  1206.      
  1207.      COMPATIBILITY
  1208.           XEDIT: N/A
  1209.           KEDIT: Adds extra functionality with [RESET] option.
  1210.      
  1211.      STATUS
  1212.           Complete.
  1213.  
  1214.  
  1215.  
  1216.      --------------------------------------------------------------------------
  1217.      COMMAND
  1218.           msg - display message on error line
  1219.      
  1220.      SYNTAX
  1221.           MSG [message]
  1222.      
  1223.      DESCRIPTION
  1224.           The MSG command displays an error message on the error line.
  1225.           This command is usually issued from a macro file.
  1226.           This is similar to EMSG, but MSG does not sound the bell if SET
  1227.           BELL is on.
  1228.      
  1229.      COMPATIBILITY
  1230.           XEDIT: Compatible.
  1231.           KEDIT: Compatible.
  1232.      
  1233.      SEE ALSO
  1234.           CMSG, EMSG
  1235.      
  1236.      STATUS
  1237.           Complete.
  1238.  
  1239.  
  1240.  
  1241.      --------------------------------------------------------------------------
  1242.      COMMAND
  1243.           next - move forward in the file a number of lines
  1244.      
  1245.      SYNTAX
  1246.           Next [relative_target]
  1247.      
  1248.      DESCRIPTION
  1249.           The NEXT command moves the current line forwards the number of
  1250.           lines specified by the relative_target. This relative_target can 
  1251.           only be a positive integer or the character "*". 
  1252.      
  1253.      COMPATIBILITY
  1254.           XEDIT: Compatible.
  1255.           KEDIT: Compatible.
  1256.      
  1257.      DEFAULT
  1258.           1
  1259.      
  1260.      SEE ALSO
  1261.           DOWN, UP
  1262.      
  1263.      STATUS
  1264.           Complete.
  1265.  
  1266.  
  1267.  
  1268.      --------------------------------------------------------------------------
  1269.      COMMAND
  1270.           nextwindow - switch focus of editing session to other window
  1271.      
  1272.      SYNTAX
  1273.           NEXTWindow
  1274.      
  1275.      DESCRIPTION
  1276.           The NEXTWINDOW command moves the focus of the editing session to
  1277.           the other window (if more than one window is currently displayed)
  1278.           or to the next file in the ring.
  1279.      
  1280.      COMPATIBILITY
  1281.           XEDIT: N/A
  1282.           KEDIT: N/A
  1283.      
  1284.      SEE ALSO
  1285.           EDIT, SCREEN
  1286.      
  1287.      STATUS
  1288.           Complete.
  1289.  
  1290.  
  1291.  
  1292.      --------------------------------------------------------------------------
  1293.      COMMAND
  1294.           nomsg - execute a command suppressing any messages 
  1295.      
  1296.      SYNTAX
  1297.           NOMSG command [parameters]
  1298.      
  1299.      DESCRIPTION
  1300.           The NOMSG command executes the supplied command but suppresses
  1301.           messages that would normally be displayed as a result of the 
  1302.           command.
  1303.      
  1304.      COMPATIBILITY
  1305.           XEDIT: N/A
  1306.           KEDIT: Compatible.
  1307.      
  1308.      STATUS
  1309.           Complete.
  1310.  
  1311.  
  1312.  
  1313.      --------------------------------------------------------------------------
  1314.      COMMAND
  1315.           nop - no operation command
  1316.      
  1317.      SYNTAX
  1318.           NOP
  1319.      
  1320.      DESCRIPTION
  1321.           The NOP command doesn't do anything. It is used as a means of
  1322.           setting a key to do nothing.
  1323.      
  1324.      COMPATIBILITY
  1325.           XEDIT: N/A
  1326.           KEDIT: N/A
  1327.      
  1328.      SEE ALSO
  1329.           DEFINE
  1330.      
  1331.      STATUS
  1332.           Complete.
  1333.  
  1334.  
  1335.  
  1336.      --------------------------------------------------------------------------
  1337.      COMMAND
  1338.           os - execute an operating system command
  1339.      
  1340.      SYNTAX
  1341.           OS [command]
  1342.      
  1343.      DESCRIPTION
  1344.           The OS command executes the supplied operating system command 
  1345.           or runs an interactive shell if no command is supplied.
  1346.      
  1347.      COMPATIBILITY
  1348.           XEDIT: N/A
  1349.           KEDIT: Equivalent to DOS command.
  1350.      
  1351.      SEE ALSO
  1352.           DOS, !
  1353.      
  1354.      STATUS
  1355.           Complete.
  1356.  
  1357.  
  1358.  
  1359.      --------------------------------------------------------------------------
  1360.      COMMAND
  1361.           osnowait - execute an operating system command - no prompt
  1362.      
  1363.      SYNTAX
  1364.           OSNowait command
  1365.      
  1366.      DESCRIPTION
  1367.           The OSNOWAIT command executes the supplied operating system 
  1368.           command not waiting for the user to be prompted once the
  1369.           command has completed.
  1370.      
  1371.      COMPATIBILITY
  1372.           XEDIT: N/A
  1373.           KEDIT: Equivalent of DOSNOWAIT command.
  1374.      
  1375.      SEE ALSO
  1376.           DOSNOWAIT
  1377.      
  1378.      STATUS
  1379.           Complete.
  1380.  
  1381.  
  1382.  
  1383.      --------------------------------------------------------------------------
  1384.      COMMAND
  1385.           osquiet - execute an operating system command quietly
  1386.      
  1387.      SYNTAX
  1388.           OSQuiet command
  1389.      
  1390.      DESCRIPTION
  1391.           The OSQUIET command executes the supplied os command as quietly
  1392.           as possible.
  1393.      
  1394.      COMPATIBILITY
  1395.           XEDIT: N/A
  1396.           KEDIT: Equivalent of DOSQUIET command.
  1397.      
  1398.      SEE ALSO
  1399.           DOSQUIET
  1400.      
  1401.      STATUS
  1402.           Complete.
  1403.  
  1404.  
  1405.  
  1406.      --------------------------------------------------------------------------
  1407.      COMMAND
  1408.           overlaybox - overlay marked box block on current cursor position
  1409.      
  1410.      SYNTAX
  1411.           OVERLAYBox
  1412.      
  1413.      DESCRIPTION
  1414.           The OVERLAYBOX copies the contents of the marked box block over the
  1415.           characters at the current cursor position or to column 1 of the
  1416.           current line if issued from the command line.
  1417.      
  1418.      COMPATIBILITY
  1419.           XEDIT: N/A
  1420.           KEDIT: Compatible.
  1421.      
  1422.      SEE ALSO
  1423.           MOVE, COPY
  1424.      
  1425.      STATUS
  1426.           Complete.
  1427.  
  1428.  
  1429.  
  1430.      --------------------------------------------------------------------------
  1431.      COMMAND
  1432.           print - send text to default printer or print spooler
  1433.      
  1434.      SYNTAX
  1435.           PRint [target] [n]
  1436.           PRint LINE [text]
  1437.           PRint STRING [text]
  1438.           PRint FORMfeed
  1439.           PRint CLOSE
  1440.      
  1441.      DESCRIPTION
  1442.           The PRINT command writes a portion of the current file to the default
  1443.           printer or print spooler, or text entered on the command line.
  1444.        
  1445.           PRINT [target] [n]
  1446.              Sends text from the file contents up to the target to the printer
  1447.              followed by a CR/LF (DOS) or LF(UNIX) after each line.
  1448.              When [n] is specified, this sends a formfeed after [n] successive
  1449.              lines of text.
  1450.           PRINT LINE [text]
  1451.              Sends the remainder of the text on the command line to the printer
  1452.              followed by a CR/LF (DOS) or LF(UNIX).
  1453.           PRINT STRING [text]
  1454.              Sends the remainder of the text on the command line to the printer
  1455.              without any trailing line terminator.
  1456.           PRINT FORMFEED
  1457.               Sends a formfeed (^L) character to the printer.
  1458.           PRINT CLOSE
  1459.               Closes the printer spooler.
  1460.      
  1461.      COMPATIBILITY
  1462.           XEDIT: N/A
  1463.           KEDIT: Compatible.
  1464.      
  1465.      SEE ALSO
  1466.           PRINTER
  1467.      
  1468.      STATUS
  1469.           Complete.
  1470.  
  1471.  
  1472.  
  1473.      --------------------------------------------------------------------------
  1474.      COMMAND
  1475.           put - write part of a file to another
  1476.      
  1477.      SYNTAX
  1478.           PUT [target] [fileid]
  1479.      
  1480.      DESCRIPTION
  1481.           The PUT command writes a portion of the current file to another
  1482.           file, either explicit or temporary.
  1483.           When no fileid is supplied the temporary file is overwritten.
  1484.           When a fileid is supplied the portion of the file written out
  1485.           is appended to the specified file.
  1486.      
  1487.      COMPATIBILITY
  1488.           XEDIT: Compatible.
  1489.           KEDIT: Compatible.
  1490.      
  1491.      SEE ALSO
  1492.           PUTD, GET
  1493.      
  1494.      STATUS
  1495.           Complete.
  1496.  
  1497.  
  1498.  
  1499.      --------------------------------------------------------------------------
  1500.      COMMAND
  1501.           putd - write part of a file to another and delete
  1502.      
  1503.      SYNTAX
  1504.           PUTD [target] [fileid]
  1505.      
  1506.      DESCRIPTION
  1507.           The PUTD command writes a portion of the current file to another
  1508.           file, either explicit or temporary and deletes those lines written.
  1509.           When no fileid is supplied the temporary file is overwritten.
  1510.           When a fileid is supplied the portion of the file written out
  1511.           is appended to the specified file.
  1512.      
  1513.      COMPATIBILITY
  1514.           XEDIT: Compatible.
  1515.           KEDIT: Compatible.
  1516.      
  1517.      SEE ALSO
  1518.           PUT, GET
  1519.      
  1520.      STATUS
  1521.           Complete.
  1522.  
  1523.  
  1524.  
  1525.      --------------------------------------------------------------------------
  1526.      COMMAND
  1527.           qquit - exit from the current file without saving changes
  1528.      
  1529.      SYNTAX
  1530.           QQuit
  1531.      
  1532.      DESCRIPTION
  1533.           The QQUIT command exits the user from the current file, whether
  1534.           changes have been made to the file or not.
  1535.           The previous file in the ring then becomes the current file.
  1536.           If the current file is the only file in the ring, the user is
  1537.           returned to the Operating System.
  1538.      
  1539.      COMPATIBILITY
  1540.           XEDIT: N/A
  1541.           KEDIT: Compatible.
  1542.      
  1543.      SEE ALSO
  1544.           QUIT
  1545.      
  1546.      STATUS
  1547.           Complete
  1548.  
  1549.  
  1550.  
  1551.      --------------------------------------------------------------------------
  1552.      COMMAND
  1553.           query - display various option settings
  1554.      
  1555.      SYNTAX
  1556.           Query item
  1557.      
  1558.      DESCRIPTION
  1559.           The QUERY command displays the various settings for options set
  1560.           by THE.
  1561.      
  1562.      COMPATIBILITY
  1563.           XEDIT: Compatible functionality, but not all options.
  1564.           KEDIT: Compatible functionality, but not all options.
  1565.      
  1566.      SEE ALSO
  1567.           STATUS, MODIFY
  1568.      
  1569.      STATUS
  1570.           Complete.
  1571.  
  1572.  
  1573.  
  1574.      --------------------------------------------------------------------------
  1575.      COMMAND
  1576.           quit - exit from the current file if no changes made
  1577.      
  1578.      SYNTAX
  1579.           QUIT
  1580.      
  1581.      DESCRIPTION
  1582.           The QUIT command exits the user from the current file, provided
  1583.           no changes have been made to the file. An error message will be
  1584.           displayed if changes have been made.
  1585.           The previous file in the ring then becomes the current file.
  1586.           If the current file is the only file in the ring, the user is
  1587.           returned to the Operating System.
  1588.      
  1589.      COMPATIBILITY
  1590.           XEDIT: Does not support return code option.
  1591.           KEDIT: Compatible.
  1592.      
  1593.      SEE ALSO
  1594.           QQUIT
  1595.      
  1596.      STATUS
  1597.           Complete
  1598.  
  1599.  
  1600.  
  1601.      --------------------------------------------------------------------------
  1602.      COMMAND
  1603.           readv - read keystrokes and pass to macro
  1604.      
  1605.      SYNTAX
  1606.           READV Cmdline|KEY
  1607.      
  1608.      DESCRIPTION
  1609.           The READV command allows a REXX macro to interact with the user 
  1610.           by accepting keystrokes.
  1611.      
  1612.           The macro obtains the entered information by setting REXX
  1613.           variables. These are set as follows:
  1614.      
  1615.           For READV KEY
  1616.      
  1617.               readv.0 = 3
  1618.               readv.1 = name of key (empty if unknown)
  1619.               readv.2 = ASCII value of key (null if not an ASCII code)
  1620.               readv.3 = curses key value (or ASCII code if an ASCII code)
  1621.      
  1622.           For READV CMDLINE
  1623.      
  1624.               readv.0 = 1
  1625.               readv.1 = contents of command line
  1626.      
  1627.      COMPATIBILITY
  1628.           XEDIT: Similar to READ CMDLINE option.
  1629.           KEDIT: Compatible.
  1630.      
  1631.      STATUS
  1632.           Incomplete. CMDLINE option not implemented.
  1633.  
  1634.  
  1635.  
  1636.      --------------------------------------------------------------------------
  1637.      COMMAND
  1638.           recover - recover changed or deleted lines
  1639.      
  1640.      SYNTAX
  1641.           RECover [n|*]
  1642.      
  1643.      DESCRIPTION
  1644.           The RECOVER command restores the last n changed or deleted lines
  1645.           back into the body of the file.
  1646.      
  1647.      COMPATIBILITY
  1648.           XEDIT: Also recovers changes to lines, not just lines deleted.
  1649.           KEDIT: Compatible.
  1650.      
  1651.      STATUS
  1652.           Complete.
  1653.  
  1654.  
  1655.  
  1656.      --------------------------------------------------------------------------
  1657.      COMMAND
  1658.           redraw - redraw the current screen
  1659.      
  1660.      SYNTAX
  1661.           REDRAW
  1662.      
  1663.      DESCRIPTION
  1664.           The REDRAW command redraws the current contents of the screen.
  1665.           This is usually used when some outside influence has affected 
  1666.           the display.
  1667.      
  1668.      COMPATIBILITY
  1669.           XEDIT: N/A
  1670.           KEDIT: N/A
  1671.      
  1672.      SEE ALSO
  1673.           REFRESH
  1674.      
  1675.      STATUS
  1676.           Complete.
  1677.  
  1678.  
  1679.  
  1680.      --------------------------------------------------------------------------
  1681.      COMMAND
  1682.           refresh - refresh the contents of the current screen
  1683.      
  1684.      SYNTAX
  1685.           REFRESH
  1686.      
  1687.      DESCRIPTION
  1688.           The REFRESH command refreshes what is being displayed on the screen.
  1689.           This is usually used from within a macro to indicate the progress
  1690.           of the macro.
  1691.      
  1692.      COMPATIBILITY
  1693.           XEDIT: Compatible.
  1694.           KEDIT: Compatible.
  1695.      
  1696.      SEE ALSO
  1697.           REDRAW
  1698.      
  1699.      STATUS
  1700.           Complete.
  1701.  
  1702.  
  1703.  
  1704.      --------------------------------------------------------------------------
  1705.      COMMAND
  1706.           repeat - repeat the last command
  1707.      
  1708.      SYNTAX
  1709.           REPEat [target]
  1710.      
  1711.      DESCRIPTION
  1712.           The REPEAT command advances the current line and executes the
  1713.           last command. It is equivalent to NEXT 1 (or UP 1) and = for
  1714.           the specified number of times.
  1715.      
  1716.      COMPATIBILITY
  1717.           XEDIT: Compatible.
  1718.           KEDIT: Compatible.
  1719.      
  1720.      STATUS
  1721.           Incomplete
  1722.  
  1723.  
  1724.  
  1725.      --------------------------------------------------------------------------
  1726.      COMMAND
  1727.           replace - replace the current line with supplied text
  1728.      
  1729.      SYNTAX
  1730.           Replace [text]
  1731.      
  1732.      DESCRIPTION
  1733.           The REPLACE command replaces the current line with the supplied
  1734.           text.
  1735.      
  1736.      COMPATIBILITY
  1737.           XEDIT: Compatible.
  1738.           KEDIT: Compatible.
  1739.      
  1740.      STATUS
  1741.           Complete.
  1742.  
  1743.  
  1744.  
  1745.      --------------------------------------------------------------------------
  1746.      COMMAND
  1747.           reset - cancel the marked block or prefix commands or both
  1748.      
  1749.      SYNTAX
  1750.           RESet ALL|Block|Prefix
  1751.      
  1752.      DESCRIPTION
  1753.           The RESET command unmarks any marked block or outstanding prefix
  1754.           commands or both.
  1755.      
  1756.      COMPATIBILITY
  1757.           XEDIT: Adds Block and All options.
  1758.           KEDIT: Compatible.
  1759.      
  1760.      STATUS
  1761.           Complete.
  1762.  
  1763.  
  1764.  
  1765.      --------------------------------------------------------------------------
  1766.      COMMAND
  1767.           rgtleft - scroll the screen to the left or right
  1768.      
  1769.      SYNTAX
  1770.           RGTLEFT [n]
  1771.      
  1772.      DESCRIPTION
  1773.           The RGTLEFT command scrolls the screen n columns to the right
  1774.           if the value of VERSHIFT is less than or equal to 0, or if
  1775.           the value of VERSHIFT is greater than 0, the screen is
  1776.           scrolled n columns to the left.
  1777.           If n is not specified, the screen scrolls by three quarters the
  1778.           number of columns displayed.
  1779.      
  1780.      COMPATIBILITY
  1781.           XEDIT: Compatible.
  1782.           KEDIT: Compatible.
  1783.      
  1784.      SEE ALSO
  1785.           LEFT, RIGHT
  1786.      
  1787.      STATUS
  1788.           Complete.
  1789.  
  1790.  
  1791.  
  1792.      --------------------------------------------------------------------------
  1793.      COMMAND
  1794.           right - scroll the screen to the right
  1795.      
  1796.      SYNTAX
  1797.           RIght [n|HALF]
  1798.      
  1799.      DESCRIPTION
  1800.           The RIGHT command scrolls the screen n columns to the right.
  1801.           If no parameter is supplied, the screen is scrolled by 1
  1802.           column. If HALF is specified the screen is scrolled by half 
  1803.           the number of columns in the FILEAREA.
  1804.      
  1805.      COMPATIBILITY
  1806.           XEDIT: Compatible.
  1807.           KEDIT: Compatible.
  1808.      
  1809.      SEE ALSO
  1810.           LEFT, RGTLEFT
  1811.      
  1812.      STATUS
  1813.           Complete.
  1814.  
  1815.  
  1816.  
  1817.      --------------------------------------------------------------------------
  1818.      COMMAND
  1819.           save - save changes to current file
  1820.      
  1821.      SYNTAX
  1822.           SAVE [fileid]
  1823.      
  1824.      DESCRIPTION
  1825.           The SAVE command writes the current file to disk. If a fileid is
  1826.           supplied, the current file is saved in that file, unless the file
  1827.           already exists which will result in an error message being
  1828.           displayed. The 'Alterations' counter on the heading line is 
  1829.           reset to zero.
  1830.      
  1831.      COMPATIBILITY
  1832.           XEDIT: Compatible.
  1833.           KEDIT: Compatible.
  1834.      
  1835.      SEE ALSO
  1836.           SSAVE, FILE, FFILE
  1837.      
  1838.      STATUS
  1839.           Complete
  1840.  
  1841.  
  1842.  
  1843.      --------------------------------------------------------------------------
  1844.      COMMAND
  1845.           schange - selectively change strings
  1846.      
  1847.      SYNTAX
  1848.           SCHange /string1/string2/ [target] [n] [m]
  1849.      
  1850.      DESCRIPTION
  1851.           The SCHANGE command changes one string of text to another.
  1852.      
  1853.           The first parameter to the change command is the old and new
  1854.           string values, seperated by delimiters.
  1855.           The allowable delimiters are '/' '\' and '@'.
  1856.      
  1857.           The second parameter is the target; how many lines are to be
  1858.           searched for occurrences of the first string to be changed.
  1859.      
  1860.           The third parameter determines how many occurrences of 'string1'
  1861.           are to be changed on each line.
  1862.      
  1863.           The fourth parameter determines at which occurrences of 'string1'
  1864.           on the line are changes to commence.
  1865.      
  1866.      COMPATIBILITY
  1867.           XEDIT: Functionally compatible, but syntax different.
  1868.           KEDIT: Compatible.
  1869.      
  1870.      DEFAULT
  1871.           1 1 1
  1872.      
  1873.      SEE ALSO
  1874.           CHANGE
  1875.      
  1876.      STATUS
  1877.           Complete.
  1878.  
  1879.  
  1880.  
  1881.      --------------------------------------------------------------------------
  1882.      COMMAND
  1883.           set - execute various set commands
  1884.      
  1885.      SYNTAX
  1886.           SET set_command [set_command parameter(s) ...]
  1887.      
  1888.      DESCRIPTION
  1889.           The SET command is a front end to existing 'set' commands. It treats
  1890.           the first parameter it receives as a command and executes it.
  1891.      
  1892.      COMPATIBILITY
  1893.           XEDIT: Compatible.
  1894.           KEDIT: Compatible.
  1895.      
  1896.      STATUS
  1897.           Complete.
  1898.  
  1899.  
  1900.  
  1901.      --------------------------------------------------------------------------
  1902.      COMMAND
  1903.           shift - move text left or right
  1904.      
  1905.      SYNTAX
  1906.           SHift Left|Right [n] [target]
  1907.      
  1908.      DESCRIPTION
  1909.           The SHIFT command moves text in the direction specified the number
  1910.           of columns [n] for the specified target lines.
  1911.      
  1912.      COMPATIBILITY
  1913.           XEDIT: Compatible.
  1914.           KEDIT: Compatible.
  1915.      
  1916.      STATUS
  1917.           Complete.
  1918.  
  1919.  
  1920.  
  1921.      --------------------------------------------------------------------------
  1922.      COMMAND
  1923.           showkey - display current key value and command assignation
  1924.      
  1925.      SYNTAX
  1926.           SHOWKey 
  1927.      
  1928.      DESCRIPTION
  1929.           The SHOWKEY command prompts the user to enter a key and responds
  1930.           with the key name and associated command (if applicable).
  1931.           To exit from SHOWKEY, press the space bar.
  1932.      
  1933.      COMPATIBILITY
  1934.           XEDIT: N/A
  1935.           KEDIT: N/A
  1936.      
  1937.      STATUS
  1938.           Complete.
  1939.  
  1940.  
  1941.  
  1942.      --------------------------------------------------------------------------
  1943.      COMMAND
  1944.           sort - sort selected lines in a file
  1945.      
  1946.      SYNTAX
  1947.           SORT target [[[Ascending|Descending] left_col right_col] [...]]
  1948.      
  1949.      DESCRIPTION
  1950.           The SORT command sort a portion of a file based on the sort field
  1951.           specifications.
  1952.           target can be any valid target including ALL, *, -*, and BLOCK.
  1953.           Each sort field specification consists of an optional ordering
  1954.           flag and a left and right column.
  1955.      
  1956.           Only 10 sort fields are allowed.
  1957.      
  1958.      COMPATIBILITY
  1959.           XEDIT: XEDIT only allows ordering flag for all fields
  1960.           KEDIT: Compatible.
  1961.      
  1962.      STATUS
  1963.           Complete.
  1964.  
  1965.  
  1966.  
  1967.      --------------------------------------------------------------------------
  1968.      COMMAND
  1969.           sos - execute various sos commands
  1970.      
  1971.      SYNTAX
  1972.           SOS sos_command [sos_command ...]
  1973.      
  1974.      DESCRIPTION
  1975.           The SOS command is a front end to existing 'sos' commands. It treats
  1976.           each parameter it receives as a command and executes it.
  1977.      
  1978.      COMPATIBILITY
  1979.           XEDIT: XEDIT only permits 1 command
  1980.           KEDIT: Compatible.
  1981.      
  1982.      STATUS
  1983.           Complete.
  1984.  
  1985.  
  1986.  
  1987.      --------------------------------------------------------------------------
  1988.      COMMAND
  1989.           split - split a line into two lines
  1990.      
  1991.      SYNTAX
  1992.           SPlit [ALigned]
  1993.      
  1994.      DESCRIPTION
  1995.           The SPLIT command splits the focus line into two lines.
  1996.           If ALIGNED is specified, the first non-blank character of the new
  1997.           line is positioned under the first non-blank character of the
  1998.           focus line. If ALIGNED is not specified, the text of the new line
  1999.           starts in column 1.
  2000.      
  2001.      COMPATIBILITY
  2002.           XEDIT: Compatible.
  2003.           KEDIT: Compatible.
  2004.      
  2005.      SEE ALSO
  2006.           JOIN, SPLTJOIN
  2007.      
  2008.      STATUS
  2009.           Complete.
  2010.  
  2011.  
  2012.  
  2013.      --------------------------------------------------------------------------
  2014.      COMMAND
  2015.           spltjoin - split/join two lines
  2016.      
  2017.      SYNTAX
  2018.           spltjoin
  2019.      
  2020.      DESCRIPTION
  2021.           The SPLTJOIN command splits the focus line into two or joins the
  2022.           focus line with the next line depending on the position of the
  2023.           cursor. If the cursor is after the last column of a line, the JOIN
  2024.           command is executed, otherwise the SPLIT command is executed.
  2025.           The text in the new line is aligned with the text in the focus line.
  2026.      
  2027.           This command can only be used by assigning it to a function key.
  2028.      
  2029.      COMPATIBILITY
  2030.           XEDIT: Compatible.
  2031.           KEDIT: Compatible.
  2032.      
  2033.      SEE ALSO
  2034.           JOIN, SPLIT
  2035.      
  2036.      STATUS
  2037.           Complete.
  2038.  
  2039.  
  2040.  
  2041.      --------------------------------------------------------------------------
  2042.      COMMAND
  2043.           ssave - force SAVE to specified file
  2044.      
  2045.      SYNTAX
  2046.           SSave [fileid]
  2047.      
  2048.      DESCRIPTION
  2049.           The SSAVE command writes the current file to disk. If a fileid is
  2050.           supplied, the current file is saved in that file, otherwise the
  2051.           current name of the file is used.
  2052.           If a fileid is supplied and that fileid already exists, the previous
  2053.           contents of that fileid will be replaced with the current file.
  2054.           The 'Alterations' counter on the heading line is reset to zero.
  2055.      
  2056.      COMPATIBILITY
  2057.           XEDIT: N/A
  2058.           KEDIT: Compatible.
  2059.      
  2060.      SEE ALSO
  2061.           SAVE, FILE, FFILE
  2062.      
  2063.      STATUS
  2064.           Complete
  2065.  
  2066.  
  2067.  
  2068.      --------------------------------------------------------------------------
  2069.      COMMAND
  2070.           status - display current settings of various variables
  2071.      
  2072.      SYNTAX
  2073.           STATus [filename]
  2074.      
  2075.      DESCRIPTION
  2076.           The STATUS command, without the optional filename, displays a full
  2077.           screen of current settings for various variables. With the filename,
  2078.           the STATUS command creates a file containing a series of SET commands
  2079.           with the current values of these settings.
  2080.      
  2081.      COMPATIBILITY
  2082.           XEDIT: Compatible.
  2083.           KEDIT: Compatible. KEDIT does not support [filename] option.
  2084.      
  2085.      SEE ALSO
  2086.           QUERY, EXTRACT, MODIFY
  2087.      
  2088.      STATUS
  2089.           Complete
  2090.  
  2091.  
  2092.  
  2093.      --------------------------------------------------------------------------
  2094.      COMMAND
  2095.           suspend - suspend THE and return to operating system
  2096.      
  2097.      SYNTAX
  2098.           SUSPend
  2099.      
  2100.      DESCRIPTION
  2101.           The SUSPEND command suspends the current editing session and 
  2102.           returns control to the operating system. Under DOS and OS/2 this
  2103.           is the equivalent of OSNowait. Under UNIX, the process gets placed
  2104.           in the background until it is brought to the foreground.
  2105.      
  2106.      COMPATIBILITY
  2107.           XEDIT: N/A
  2108.           KEDIT: N/A
  2109.      
  2110.      SEE ALSO
  2111.           OSNOWAIT
  2112.      
  2113.      STATUS
  2114.           Complete
  2115.  
  2116.  
  2117.  
  2118.      --------------------------------------------------------------------------
  2119.      COMMAND
  2120.           tabpre - switch between FILEAREA and PREFIX area
  2121.      
  2122.      SYNTAX
  2123.           tabpre
  2124.      
  2125.      DESCRIPTION
  2126.           The TABPRE command switches the focus of the editor from the
  2127.           FILEAREA to the PREFIX area and vice versa, depending
  2128.           on which window is currently active.
  2129.      
  2130.           This command can only be used by assigning it to a function key.
  2131.      
  2132.           This command will be removed in a future version.
  2133.      
  2134.      COMPATIBILITY
  2135.           XEDIT: N/A
  2136.           KEDIT: Equivalent of SOS LEFTEDGE and SOS PREFIX
  2137.      
  2138.      SEE ALSO
  2139.           SOS LEFTEDGE, SOS PREFIX
  2140.      
  2141.      STATUS
  2142.           Complete.
  2143.  
  2144.  
  2145.  
  2146.      --------------------------------------------------------------------------
  2147.      COMMAND
  2148.           text - simulate keyboard entry of characters
  2149.      
  2150.      SYNTAX
  2151.           TEXT text
  2152.      
  2153.      DESCRIPTION
  2154.           The TEXT command simulates the entry of characters from the
  2155.           keyboard. This command is actually called when you enter text
  2156.           from the keyboard.
  2157.      
  2158.      COMPATIBILITY
  2159.           XEDIT: N/A
  2160.           KEDIT: Compatible.
  2161.                  Does not allow trailing spaces in text.
  2162.      
  2163.      STATUS
  2164.           Complete.
  2165.  
  2166.  
  2167.  
  2168.      --------------------------------------------------------------------------
  2169.      COMMAND
  2170.           the - edit another file or switch to next file
  2171.      
  2172.      SYNTAX
  2173.           THE [filename]
  2174.      
  2175.      DESCRIPTION
  2176.           The THE command allows the user to edit another file. The new file
  2177.           is placed in the file ring. The previous file being edited remains
  2178.           in memory and can be returned to by issuing a THE command without
  2179.           any parameters. Several files can be edited at once, and all files
  2180.           are arranged in a ring, with subsequent THE commands moving through
  2181.           the ring, one file at a time.
  2182.      
  2183.      COMPATIBILITY
  2184.           XEDIT: Does not provide options switches.
  2185.           KEDIT: Does not provide options switches.
  2186.      
  2187.      SEE ALSO
  2188.           XEDIT, EDIT
  2189.      
  2190.      STATUS
  2191.           Complete.
  2192.  
  2193.  
  2194.  
  2195.      --------------------------------------------------------------------------
  2196.      COMMAND
  2197.           top - move to the top of the file
  2198.      
  2199.      SYNTAX
  2200.           TOP
  2201.      
  2202.      DESCRIPTION
  2203.           The TOP command moves to the very start of the current file.
  2204.           The "Top-of-file" line is set to the current_line.
  2205.      
  2206.           "TOP" is equivalent to "BACKWARD *".
  2207.      
  2208.      COMPATIBILITY
  2209.           XEDIT: Compatible.
  2210.           KEDIT: Compatible.
  2211.      
  2212.      SEE ALSO
  2213.           BACKWARD, BOTTOM
  2214.      
  2215.      STATUS
  2216.           Complete
  2217.  
  2218.  
  2219.  
  2220.      --------------------------------------------------------------------------
  2221.      COMMAND
  2222.           up - move backward in the file a number of lines
  2223.      
  2224.      SYNTAX
  2225.           Up [relative_target]
  2226.      
  2227.      DESCRIPTION
  2228.           The UP command moves the current line backwards the number of
  2229.           lines specified by the relative_target. This relative_target can 
  2230.           only be a positive integer or the character "*". 
  2231.      
  2232.      COMPATIBILITY
  2233.           XEDIT: Compatible.
  2234.           KEDIT: Compatible.
  2235.      
  2236.      DEFAULT
  2237.           1
  2238.      
  2239.      SEE ALSO
  2240.           NEXT, DOWN
  2241.      
  2242.      STATUS
  2243.           Complete.
  2244.  
  2245.  
  2246.  
  2247.      --------------------------------------------------------------------------
  2248.      COMMAND
  2249.           uppercase - change lowercase characters to uppercase
  2250.      
  2251.      SYNTAX
  2252.           UPPercase [target]
  2253.      
  2254.      DESCRIPTION
  2255.           The UPPERCASE command changes all lowercase characters in all
  2256.           lines up to the target line to uppercase. All other characters 
  2257.           remain untouched.
  2258.      
  2259.      COMPATIBILITY
  2260.           XEDIT: Equivalent of UPPERCAS
  2261.           KEDIT: Compatible.
  2262.      
  2263.      SEE ALSO
  2264.           LOWERCASE
  2265.      
  2266.      STATUS
  2267.           Complete.
  2268.  
  2269.  
  2270.  
  2271.      --------------------------------------------------------------------------
  2272.      COMMAND
  2273.           xedit - edit another file or switch to next file
  2274.      
  2275.      SYNTAX
  2276.           Xedit [filename]
  2277.      
  2278.      DESCRIPTION
  2279.           The XEDIT command allows the user to edit another file. The new file
  2280.           is placed in the file ring. The previous file being edited remains
  2281.           in memory and can be returned to by issuing an XEDIT command without
  2282.           any parameters. Several files can be edited at once, and all files
  2283.           are arranged in a ring, with subsequent XEDIT commands moving through
  2284.           the ring, one file at a time.
  2285.      
  2286.      COMPATIBILITY
  2287.           XEDIT: Does not provide options switches.
  2288.           KEDIT: Does not provide options switches.
  2289.      
  2290.      SEE ALSO
  2291.           EDIT, THE
  2292.      
  2293.      STATUS
  2294.           Complete.
  2295.  
  2296.  
  2297.  
  2298.      --------------------------------------------------------------------------
  2299.      COMMAND
  2300.           retrieve - return the next/prior command on the command line
  2301.      
  2302.      SYNTAX
  2303.           ?[+]
  2304.      
  2305.      DESCRIPTION
  2306.           The ? command returns the next or prior command from the command
  2307.           line stack and displays it on the command line.
  2308.           With no parameters, the most recent command entered on the command
  2309.           line is retrieved.
  2310.      
  2311.      COMPATIBILITY
  2312.           XEDIT: Compatible.
  2313.           KEDIT: See below..
  2314.           Does not support multiple '?' as in ??? to retrieve the third last
  2315.           command.
  2316.           This command is bound to the up and down arrows when on the
  2317.           command line depending on the setting of CMDARROWS.
  2318.      
  2319.      SEE ALSO
  2320.           SET CMDARROWS
  2321.      
  2322.      STATUS
  2323.           Complete.
  2324.  
  2325.  
  2326.  
  2327.      --------------------------------------------------------------------------
  2328.      COMMAND
  2329.           = - re-execute the last command issued on the command line
  2330.      
  2331.      SYNTAX
  2332.           =
  2333.      
  2334.      DESCRIPTION
  2335.           The = command retrieves the most recently issued command from
  2336.           the command line and re-executes it.
  2337.      
  2338.      COMPATIBILITY
  2339.           XEDIT: Does not support optional [subcommand] option.
  2340.           KEDIT: Does not support optional [command] option.
  2341.      
  2342.      STATUS
  2343.           Complete.
  2344.  
  2345.  
  2346.  
  2347.      --------------------------------------------------------------------------
  2348.      COMMAND
  2349.           ! - execute an operating system command
  2350.      
  2351.      SYNTAX
  2352.           ! [command]
  2353.      
  2354.      DESCRIPTION
  2355.           The OS command executes the supplied operating system command 
  2356.           or runs an interactive shell if no command is supplied.
  2357.      
  2358.      COMPATIBILITY
  2359.           XEDIT: N/A
  2360.           KEDIT: Equivalent to DOS command.
  2361.      
  2362.      SEE ALSO
  2363.           DOS, OS
  2364.      
  2365.      STATUS
  2366.           Complete.
  2367.  
  2368.  
  2369.  
  2370.      --------------------------------------------------------------------------
  2371.      
  2372.      
  2373.      
  2374.      ========================================================================
  2375.      SOS COMMAND REFERENCE
  2376.      ========================================================================
  2377.  
  2378.  
  2379.  
  2380.      --------------------------------------------------------------------------
  2381.      COMMAND
  2382.           sos addline - add blank line after focus line
  2383.      
  2384.      SYNTAX
  2385.           SOS ADDline
  2386.      
  2387.      DESCRIPTION
  2388.           The SOS ADDLINE command inserts a blank line in the file following
  2389.           the focus line. The cursor is placed in the column under the first
  2390.           non-blank in the focus line.
  2391.      
  2392.      COMPATIBILITY
  2393.           XEDIT: Compatible.
  2394.           KEDIT: Compatible.
  2395.      
  2396.      SEE ALSO
  2397.           SOS LINEADD, SOS DELLINE
  2398.      
  2399.      STATUS
  2400.           Complete
  2401.  
  2402.  
  2403.  
  2404.      --------------------------------------------------------------------------
  2405.      COMMAND
  2406.           sos bottomedge - move cursor to bottom edge of FILEAREA
  2407.      
  2408.      SYNTAX
  2409.           SOS BOTTOMEdge
  2410.      
  2411.      DESCRIPTION
  2412.           The SOS BOTTOMEDGE command moves the cursor to the last 
  2413.           enterable line in the FILEAREA or PREFIX area. If the cursor
  2414.           is on the command line, the cursor moves to the first 
  2415.           enterable line of the FILEAREA.
  2416.      
  2417.      COMPATIBILITY
  2418.           XEDIT: N/A
  2419.           KEDIT: Comaptible.
  2420.      
  2421.      SEE ALSO
  2422.           SOS TOPEDGE
  2423.      
  2424.      STATUS
  2425.           Complete.
  2426.  
  2427.  
  2428.  
  2429.      --------------------------------------------------------------------------
  2430.      COMMAND
  2431.           sos current - move cursor to current line
  2432.      
  2433.      SYNTAX
  2434.           SOS CURRent
  2435.      
  2436.      DESCRIPTION
  2437.           The SOS CURRENT command moves the cursor to the current column
  2438.           of the cursor line from any window.
  2439.      
  2440.      COMPATIBILITY
  2441.           XEDIT: N/A
  2442.           KEDIT: Compatible.
  2443.      
  2444.      STATUS
  2445.           Complete
  2446.  
  2447.  
  2448.  
  2449.      --------------------------------------------------------------------------
  2450.      COMMAND
  2451.           sos cursoradj - move first non-blank character to cursor
  2452.      
  2453.      SYNTAX
  2454.           SOS CURSORAdj
  2455.      
  2456.      DESCRIPTION
  2457.           The SOS CURSORADJ command moves text in the focus line so that
  2458.           the first non-blank character appears under the cursor position.
  2459.      
  2460.      COMPATIBILITY
  2461.           XEDIT: N/A
  2462.           KEDIT: Compatible.
  2463.      
  2464.      STATUS
  2465.           Complete
  2466.  
  2467.  
  2468.  
  2469.      --------------------------------------------------------------------------
  2470.      COMMAND
  2471.           sos delback - delete the character to the left of the cursor
  2472.      
  2473.      SYNTAX
  2474.           SOS DELBAck
  2475.      
  2476.      DESCRIPTION
  2477.           The SOS DELBACK command moves the cursor one character to the left
  2478.           and deletes the character now under the cursor.
  2479.      
  2480.      COMPATIBILITY
  2481.           XEDIT: N/A
  2482.           KEDIT: Compatible.
  2483.      
  2484.      SEE ALSO
  2485.           SOS DELCHAR
  2486.      
  2487.      STATUS
  2488.           Complete
  2489.  
  2490.  
  2491.  
  2492.      --------------------------------------------------------------------------
  2493.      COMMAND
  2494.           sos delchar - delete character under cursor
  2495.      
  2496.      SYNTAX
  2497.           SOS DELChar
  2498.      
  2499.      DESCRIPTION
  2500.           The SOS DELCHAR command deletes the character under the cursor.
  2501.           Text to the right is shifted to the left.
  2502.      
  2503.      COMPATIBILITY
  2504.           XEDIT: N/A
  2505.           KEDIT: Compatible.
  2506.      
  2507.      SEE ALSO
  2508.           SOS DELBACK
  2509.      
  2510.      STATUS
  2511.           Complete
  2512.  
  2513.  
  2514.  
  2515.      --------------------------------------------------------------------------
  2516.      COMMAND
  2517.           sos delend - delete to end of line
  2518.      
  2519.      SYNTAX
  2520.           SOS DELEnd
  2521.      
  2522.      DESCRIPTION
  2523.           The SOS DELEND command deletes all characters from the current
  2524.           column to the end of line.
  2525.      
  2526.      COMPATIBILITY
  2527.           XEDIT: N/A
  2528.           KEDIT: Compatible.
  2529.      
  2530.      STATUS
  2531.           Complete.
  2532.  
  2533.  
  2534.  
  2535.      --------------------------------------------------------------------------
  2536.      COMMAND
  2537.           sos delline - delete focus line
  2538.      
  2539.      SYNTAX
  2540.           SOS DELLine
  2541.      
  2542.      DESCRIPTION
  2543.           The SOS DELLINE command deletes the focus line.
  2544.      
  2545.      COMPATIBILITY
  2546.           XEDIT: Compatible.
  2547.           KEDIT: Compatible.
  2548.      
  2549.      SEE ALSO
  2550.           SOS LINEDEL, SOS ADDLINE
  2551.      
  2552.      STATUS
  2553.           Complete
  2554.  
  2555.  
  2556.  
  2557.      --------------------------------------------------------------------------
  2558.      COMMAND
  2559.           sos delword - delete word at or right of cursor
  2560.      
  2561.      SYNTAX
  2562.           SOS DELWord
  2563.      
  2564.      DESCRIPTION
  2565.           The SOS DELWORD command deletes the word at or to the right
  2566.           of the current cursor position and any spaces following the 
  2567.           word.
  2568.      
  2569.      COMPATIBILITY
  2570.           XEDIT: N/A
  2571.           KEDIT: Compatible.
  2572.      
  2573.      STATUS
  2574.           Complete
  2575.  
  2576.  
  2577.  
  2578.      --------------------------------------------------------------------------
  2579.      COMMAND
  2580.           sos doprefix - execute any pending prefix commands
  2581.      
  2582.      SYNTAX
  2583.           SOS DOPREfix
  2584.      
  2585.      DESCRIPTION
  2586.           The SOS DOPREFIX command executes any pending prefix commands.
  2587.      
  2588.      COMPATIBILITY
  2589.           XEDIT: N/A
  2590.           KEDIT: Compatible.
  2591.      
  2592.      STATUS
  2593.           Complete
  2594.  
  2595.  
  2596.  
  2597.      --------------------------------------------------------------------------
  2598.      COMMAND
  2599.           sos edit - edit a file from directory list
  2600.      
  2601.      SYNTAX
  2602.           SOS EDIT
  2603.      
  2604.      DESCRIPTION
  2605.           The SOS EDIT command allows the user to edit a file, chosen from
  2606.           a directory list.(the file DIR.DIR).
  2607.      
  2608.      COMPATIBILITY
  2609.           XEDIT: N/A
  2610.           KEDIT: Compatible with default definition for Alt-X key.
  2611.      
  2612.      STATUS
  2613.           Complete.
  2614.  
  2615.  
  2616.  
  2617.      --------------------------------------------------------------------------
  2618.      COMMAND
  2619.           sos endchar - move cursor to end of focus line
  2620.      
  2621.      SYNTAX
  2622.           SOS ENDChar
  2623.      
  2624.      DESCRIPTION
  2625.           The SOS ENDCHAR command moves the cursor to the position after
  2626.           the last character displayed in the current window.
  2627.      
  2628.      COMPATIBILITY
  2629.           XEDIT: N/A
  2630.           KEDIT: Compatible.
  2631.      
  2632.      SEE ALSO
  2633.           SOS STARTENDCHAR
  2634.      
  2635.      STATUS
  2636.           Complete.
  2637.  
  2638.  
  2639.  
  2640.      --------------------------------------------------------------------------
  2641.      COMMAND
  2642.           sos execute - move cursor to command line and execute command
  2643.      
  2644.      SYNTAX
  2645.           SOS EXecute
  2646.      
  2647.      DESCRIPTION
  2648.           The SOS EXECUTE command moves the cursor to the command line
  2649.           and executes any command that is on the command line.
  2650.      
  2651.      COMPATIBILITY
  2652.           XEDIT: N/A
  2653.           KEDIT: Compatible
  2654.      
  2655.      STATUS
  2656.           Complete. 
  2657.  
  2658.  
  2659.  
  2660.      --------------------------------------------------------------------------
  2661.      COMMAND
  2662.           sos firstchar - move cursor to first non-blank of field
  2663.      
  2664.      SYNTAX
  2665.           SOS FIRSTCHar
  2666.      
  2667.      DESCRIPTION
  2668.           The SOS FIRSTCHAR command moves the cursor to the first
  2669.           non-blank character of the cursor field
  2670.      
  2671.      COMPATIBILITY
  2672.           XEDIT: N/A
  2673.           KEDIT: Compatible
  2674.      
  2675.      SEE ALSO
  2676.           SOS FIRSTCOL
  2677.      
  2678.      STATUS
  2679.           Complete.
  2680.  
  2681.  
  2682.  
  2683.      --------------------------------------------------------------------------
  2684.      COMMAND
  2685.           sos firstcol - move cursor to first column of field
  2686.      
  2687.      SYNTAX
  2688.           SOS FIRSTCOl
  2689.      
  2690.      DESCRIPTION
  2691.           The SOS FIRSTCOL command moves the cursor to the first
  2692.           column of the cursor field
  2693.      
  2694.      COMPATIBILITY
  2695.           XEDIT: N/A
  2696.           KEDIT: Compatible
  2697.      
  2698.      SEE ALSO
  2699.           SOS FIRSTCHAR, SOS LASTCOL
  2700.      
  2701.      STATUS
  2702.           Complete.
  2703.  
  2704.  
  2705.  
  2706.      --------------------------------------------------------------------------
  2707.      COMMAND
  2708.           sos lastcol - move cursor to last column of field
  2709.      
  2710.      SYNTAX
  2711.           SOS LASTCOl
  2712.      
  2713.      DESCRIPTION
  2714.           The SOS LASTCOL command moves the cursor to the last column
  2715.           of the cursor field.
  2716.      
  2717.      COMPATIBILITY
  2718.           XEDIT: N/A
  2719.           KEDIT: N/A
  2720.      
  2721.      SEE ALSO
  2722.           SOS FIRSTCOL
  2723.      
  2724.      STATUS
  2725.           Complete.
  2726.  
  2727.  
  2728.  
  2729.      --------------------------------------------------------------------------
  2730.      COMMAND
  2731.           sos leftedge - move cursor to left edge of window
  2732.      
  2733.      SYNTAX
  2734.           SOS LEFTEdge
  2735.      
  2736.      DESCRIPTION
  2737.           The SOS LEFTEDGE command moves the cursor to the leftmost edge
  2738.           of the filearea if not on the command line or to the leftmost
  2739.           edge of the command line if on the command line.
  2740.      
  2741.      COMPATIBILITY
  2742.           XEDIT: N/A
  2743.           KEDIT: Compatible
  2744.      
  2745.      SEE ALSO
  2746.           SOS RIGHTEDGE, SOS PREFIX
  2747.      
  2748.      STATUS
  2749.           Complete.
  2750.  
  2751.  
  2752.  
  2753.      --------------------------------------------------------------------------
  2754.      COMMAND
  2755.           sos lineadd - add blank line after focus line
  2756.      
  2757.      SYNTAX
  2758.           SOS LINEAdd
  2759.      
  2760.      DESCRIPTION
  2761.           The SOS LINEADD command inserts a blank line in the file following
  2762.           the focus line. The cursor is placed in the column under the first
  2763.           non-blank in the focus line.
  2764.      
  2765.      COMPATIBILITY
  2766.           XEDIT: Compatible.
  2767.           KEDIT: Compatible.
  2768.      
  2769.      SEE ALSO
  2770.           SOS ADDLINE, SOS LINEDEL
  2771.      
  2772.      STATUS
  2773.           Complete
  2774.  
  2775.  
  2776.  
  2777.      --------------------------------------------------------------------------
  2778.      COMMAND
  2779.           sos linedel - delete focus line
  2780.      
  2781.      SYNTAX
  2782.           SOS LINEDel
  2783.      
  2784.      DESCRIPTION
  2785.           The SOS LINEDEL command deletes the focus line.
  2786.      
  2787.      COMPATIBILITY
  2788.           XEDIT: Compatible.
  2789.           KEDIT: Compatible.
  2790.      
  2791.      SEE ALSO
  2792.           SOS DELLINE, SOS LINEADD
  2793.      
  2794.      STATUS
  2795.           Complete
  2796.  
  2797.  
  2798.  
  2799.      --------------------------------------------------------------------------
  2800.      COMMAND
  2801.           sos makecurr - make focus line the current line
  2802.      
  2803.      SYNTAX
  2804.           SOS MAKECURR
  2805.      
  2806.      DESCRIPTION
  2807.           The SOS MAKECURR command set the current line to the current focus
  2808.           line.
  2809.      
  2810.      COMPATIBILITY
  2811.           XEDIT: N/A
  2812.           KEDIT: Compatible.
  2813.      
  2814.      STATUS
  2815.           Complete
  2816.  
  2817.  
  2818.  
  2819.      --------------------------------------------------------------------------
  2820.      COMMAND
  2821.           sos marginl - move cursor to the left margin column
  2822.      
  2823.      SYNTAX
  2824.           SOS MARGINL
  2825.      
  2826.      DESCRIPTION
  2827.           The SOS MARGINL command moves the cursor to the left margin
  2828.           column.
  2829.      
  2830.      COMPATIBILITY
  2831.           XEDIT: N/A
  2832.           KEDIT: Compatible.
  2833.                  Although, when issued from the command line, nothing
  2834.                  happens.
  2835.      
  2836.      STATUS
  2837.           Complete
  2838.  
  2839.  
  2840.  
  2841.      --------------------------------------------------------------------------
  2842.      COMMAND
  2843.           sos marginr - move cursor to the right margin column
  2844.      
  2845.      SYNTAX
  2846.           SOS MARGINR
  2847.      
  2848.      DESCRIPTION
  2849.           The SOS MARGINR command moves the cursor to the right margin
  2850.           column.
  2851.      
  2852.      COMPATIBILITY
  2853.           XEDIT: N/A
  2854.           KEDIT: Compatible.
  2855.                  Although, when issued from the command line, nothing
  2856.                  happens.
  2857.      
  2858.      STATUS
  2859.           Complete
  2860.  
  2861.  
  2862.  
  2863.      --------------------------------------------------------------------------
  2864.      COMMAND
  2865.           sos parindent - move cursor to the paragraph indent column
  2866.      
  2867.      SYNTAX
  2868.           SOS PARINDent
  2869.      
  2870.      DESCRIPTION
  2871.           The SOS PARINDENT command moves the cursor to the paragraph
  2872.           indent column.
  2873.      
  2874.      COMPATIBILITY
  2875.           XEDIT: N/A
  2876.           KEDIT: Compatible.
  2877.                  Although, when issued from the command line, nothing
  2878.                  happens.
  2879.      
  2880.      STATUS
  2881.           Complete
  2882.  
  2883.  
  2884.  
  2885.      --------------------------------------------------------------------------
  2886.      COMMAND
  2887.           sos prefix - move cursor to leftmost edge of prefix area
  2888.      
  2889.      SYNTAX
  2890.           SOS PREfix
  2891.      
  2892.      DESCRIPTION
  2893.           The SOS PREFIX command moves the cursor to the rightmost edge
  2894.           of the prefix area.
  2895.      
  2896.      COMPATIBILITY
  2897.           XEDIT: N/A
  2898.           KEDIT: Compatible
  2899.      
  2900.      SEE ALSO
  2901.           SOS LEFTEDGE, SOS RIGHTEDGE
  2902.      
  2903.      STATUS
  2904.           Complete.
  2905.  
  2906.  
  2907.  
  2908.      --------------------------------------------------------------------------
  2909.      COMMAND
  2910.           sos qcmnd - move cursor to command line and clear
  2911.      
  2912.      SYNTAX
  2913.           SOS QCmnd
  2914.      
  2915.      DESCRIPTION
  2916.           The SOS QCMND command moves the cursor to the first column of
  2917.           the command line and clears the command line.
  2918.      
  2919.      COMPATIBILITY
  2920.           XEDIT: N/A
  2921.           KEDIT: Compatible
  2922.      
  2923.      SEE ALSO
  2924.           SOS EXECUTE
  2925.      
  2926.      STATUS
  2927.           Complete.
  2928.  
  2929.  
  2930.  
  2931.      --------------------------------------------------------------------------
  2932.      COMMAND
  2933.           sos rightedge - move cursor to right edge of window
  2934.      
  2935.      SYNTAX
  2936.           SOS RIGHTEdge
  2937.      
  2938.      DESCRIPTION
  2939.           The SOS RIGHTEDGE command moves the cursor to the rightmost edge
  2940.           of the filearea if not on the command line or to the rightmost
  2941.           edge of the command line if on the command line.
  2942.      
  2943.      COMPATIBILITY
  2944.           XEDIT: N/A
  2945.           KEDIT: Compatible
  2946.      
  2947.      SEE ALSO
  2948.           SOS LEFTEDGE, SOS PREFIX
  2949.      
  2950.      STATUS
  2951.           Complete.
  2952.  
  2953.  
  2954.  
  2955.      --------------------------------------------------------------------------
  2956.      COMMAND
  2957.           sos startendchar - move cursor to end/start of focus line
  2958.      
  2959.      SYNTAX
  2960.           SOS STARTENDChar
  2961.      
  2962.      DESCRIPTION
  2963.           The SOS STARTENDCHAR command moves the cursor to the first character
  2964.           displayed in the current window, if the cursor is after the last
  2965.           character displayed in the current window, or to the position after
  2966.           the last character displayed in the current window, if the cursor is
  2967.           anywhere else.
  2968.      
  2969.      COMPATIBILITY
  2970.           XEDIT: N/A
  2971.           KEDIT: N/A
  2972.      
  2973.      SEE ALSO
  2974.           SOS ENDCHAR
  2975.      
  2976.      STATUS
  2977.           Complete.
  2978.  
  2979.  
  2980.  
  2981.      --------------------------------------------------------------------------
  2982.      COMMAND
  2983.           sos tabb - move cursor to previous tab stop
  2984.      
  2985.      SYNTAX
  2986.           SOS TABB
  2987.      
  2988.      DESCRIPTION
  2989.           The SOS TABB command causes the cursor to move to the previous tab
  2990.           column as set by the SET TABS command.
  2991.           If the resulting column is beyond the left hand edge of the main
  2992.           window, the window will scroll half a window.
  2993.      
  2994.      COMPATIBILITY
  2995.           XEDIT: Does not allow arguments.
  2996.           KEDIT: Compatible. See below.
  2997.           Does not line tab to next line if before the left hand tab column.
  2998.      
  2999.      SEE ALSO
  3000.           SET TABS, SOS TABF
  3001.      
  3002.      STATUS
  3003.           Complete.
  3004.  
  3005.  
  3006.  
  3007.      --------------------------------------------------------------------------
  3008.      COMMAND
  3009.           sos tabf - move cursor to next tab stop
  3010.      
  3011.      SYNTAX
  3012.           SOS TABf
  3013.      
  3014.      DESCRIPTION
  3015.           The SOS TABF command causes the cursor to move to the next tab column
  3016.           as set by the SET TABS command.
  3017.           If the resulting column is beyond the right hand edge of the main
  3018.           window, the window will scroll half a window.
  3019.      
  3020.      COMPATIBILITY
  3021.           XEDIT: Does not allow arguments.
  3022.           KEDIT: Compatible. See below.
  3023.           Does not line tab to next line if after the right hand tab column.
  3024.      
  3025.      SEE ALSO
  3026.           SET TABS, SOS TABB
  3027.      
  3028.      STATUS
  3029.           Complete.
  3030.  
  3031.  
  3032.  
  3033.      --------------------------------------------------------------------------
  3034.      COMMAND
  3035.           sos tabfieldb - move cursor to previous enterable field
  3036.      
  3037.      SYNTAX
  3038.           SOS TABFIELDB
  3039.      
  3040.      DESCRIPTION
  3041.           The SOS TABFIELDB command causes the cursor to move to the first
  3042.           column of the current enterable field. If the cursor is already
  3043.           in the first column of the current field the cursor moves to the
  3044.           first column of the previous enterable field on the screen. 
  3045.           This command is intended to mimic the behavior of the SHIFT-TAB 
  3046.           key on a 3270 terminal.
  3047.      
  3048.      COMPATIBILITY
  3049.           XEDIT: N/A
  3050.           KEDIT: Compatible.
  3051.      
  3052.      SEE ALSO
  3053.           SOS TABFIELDF
  3054.      
  3055.      STATUS
  3056.           Complete.
  3057.  
  3058.  
  3059.  
  3060.      --------------------------------------------------------------------------
  3061.      COMMAND
  3062.           sos tabfieldf - move cursor to next enterable field
  3063.      
  3064.      SYNTAX
  3065.           SOS TABFIELDf
  3066.      
  3067.      DESCRIPTION
  3068.           The SOS TABFIELDF command causes the cursor to move to the next 
  3069.           enterable field on the screen. This command is intended to
  3070.           mimic the behavior of the TAB key on a 3270 terminal.
  3071.      
  3072.      COMPATIBILITY
  3073.           XEDIT: N/A
  3074.           KEDIT: Compatible.
  3075.      
  3076.      SEE ALSO
  3077.           SOS TABFIELDB
  3078.      
  3079.      STATUS
  3080.           Complete.
  3081.  
  3082.  
  3083.  
  3084.      --------------------------------------------------------------------------
  3085.      COMMAND
  3086.           sos tabwordb - move cursor to beginning of previous word
  3087.      
  3088.      SYNTAX
  3089.           SOS TABWORDB
  3090.      
  3091.      DESCRIPTION
  3092.           The SOS TABWORDB command causes the cursor to move to the first character
  3093.           of the word to the left or to the start of the line if no more
  3094.           words precede.
  3095.           If the resulting column is beyond the left hand edge of the 
  3096.           FILEAREA, the window will scroll half a window.
  3097.      
  3098.      COMPATIBILITY
  3099.           XEDIT: N/A
  3100.           KEDIT: Compatible.
  3101.      
  3102.      SEE ALSO
  3103.           SOS TABWORDF
  3104.      
  3105.      STATUS
  3106.           Complete.
  3107.  
  3108.  
  3109.  
  3110.      --------------------------------------------------------------------------
  3111.      COMMAND
  3112.           sos tabwordf - move cursor to start of next word
  3113.      
  3114.      SYNTAX
  3115.           SOS TABWORDf
  3116.      
  3117.      DESCRIPTION
  3118.           The SOS TABWORDF command causes the cursor to move to the first character
  3119.           of the next word to the right or to the end of the line if no more
  3120.           words follow.
  3121.           If the resulting column is beyond the right hand edge of the
  3122.           FILEAREA, the window will scroll half a window.
  3123.      
  3124.      COMPATIBILITY
  3125.           XEDIT: N/A
  3126.           KEDIT: Compatible.
  3127.      
  3128.      SEE ALSO
  3129.           SOS TABWORDB
  3130.      
  3131.      STATUS
  3132.           Complete.
  3133.  
  3134.  
  3135.  
  3136.      --------------------------------------------------------------------------
  3137.      COMMAND
  3138.           sos topedge - move cursor to top edge of filearea
  3139.      
  3140.      SYNTAX
  3141.           SOS TOPEdge
  3142.      
  3143.      DESCRIPTION
  3144.           The SOS TOPEDGE command moves the cursor to the first
  3145.           enterable line in the FILEAREA or PREFIX area. If the cursor
  3146.           is on the command line, the cursor moves to the first 
  3147.           enterable line of the FILEAREA.
  3148.      
  3149.      COMPATIBILITY
  3150.           XEDIT: N/A
  3151.           KEDIT: Comaptible.
  3152.      
  3153.      SEE ALSO
  3154.           SOS BOTTOMEDGE
  3155.      
  3156.      STATUS
  3157.           Complete.
  3158.  
  3159.  
  3160.  
  3161.      --------------------------------------------------------------------------
  3162.      COMMAND
  3163.           sos undo - undo changes to the current line
  3164.      
  3165.      SYNTAX
  3166.           SOS UNDO
  3167.      
  3168.      DESCRIPTION
  3169.           The SOS UNDO command causes the contents of the focus line (or the
  3170.           command line) to be reset to the contents before the cursor was
  3171.           positioned there.
  3172.      
  3173.      COMPATIBILITY
  3174.           XEDIT: N/A
  3175.           KEDIT: Compatible. 
  3176.      
  3177.      STATUS
  3178.           Complete.
  3179.  
  3180.  
  3181.  
  3182.      --------------------------------------------------------------------------
  3183.      
  3184.      
  3185.      
  3186.      ========================================================================
  3187.      SET COMMAND REFERENCE
  3188.      ========================================================================
  3189.  
  3190.  
  3191.  
  3192.      --------------------------------------------------------------------------
  3193.      COMMAND
  3194.           arbchar - set arbitrary character(s) for targets
  3195.      
  3196.      SYNTAX
  3197.           [SET] ARBchar ON|OFF [char1] [char2]
  3198.      
  3199.      DESCRIPTION
  3200.           Set the character to use as an 'arbitrary character' in string
  3201.           targets. The first arbitrary character matches a group of zero
  3202.           or more characters, the second will match exactly one character.
  3203.      
  3204.      COMPATIBILITY
  3205.           XEDIT: Compatible.
  3206.                  Single arbitrary character not supported.
  3207.           KEDIT: Compatible.
  3208.      
  3209.      DEFAULT
  3210.           OFF $ ?
  3211.      
  3212.      STATUS
  3213.           Multiple arbitrary character matching is not implemented.
  3214.  
  3215.  
  3216.  
  3217.      --------------------------------------------------------------------------
  3218.      COMMAND
  3219.           autosave - set autosave period
  3220.      
  3221.      SYNTAX
  3222.           [SET] AUtosave n|OFF
  3223.      
  3224.      DESCRIPTION
  3225.           The AUTOSAVE command sets the interval between automatic saves
  3226.           of the file, or turns it off altogether.
  3227.      
  3228.      COMPATIBILITY
  3229.           XEDIT: Does not support [mode] option.
  3230.           KEDIT: Compatible.
  3231.      
  3232.      DEFAULT
  3233.           OFF
  3234.      
  3235.      STATUS
  3236.           Complete.
  3237.  
  3238.  
  3239.  
  3240.      --------------------------------------------------------------------------
  3241.      COMMAND
  3242.           backup - indicate if a backup copy of the file is to be kept
  3243.      
  3244.      SYNTAX
  3245.           [SET] BACKup OFF|TEMP|KEEP|ON
  3246.      
  3247.      DESCRIPTION
  3248.           The BACKUP command allows the user to determine if a backup copy
  3249.           of the original file is to be kept when the file being edited is
  3250.           saved or filed.
  3251.      
  3252.           BACKUP KEEP and BACKUP ON are the same. BACKUP ON is kept for
  3253.           compatability with previous versions of THE.
  3254.      
  3255.           With BACKUP OFF, the file being written to disk will replace an
  3256.           existing file. There is a chance that you will end up with neither
  3257.           the old version of the file or the new one if problems occur
  3258.           while the file is being written.
  3259.      
  3260.           With BACKUP TEMP or KEEP, the file being written is first renamed
  3261.           to the filename with a .bak extension. The file in memory is 
  3262.           then written to disk. If BACKUP TEMP is in effect, the backup
  3263.           file is then deleted.
  3264.      
  3265.      COMPATIBILITY
  3266.           XEDIT: N/A
  3267.           KEDIT: Compatible.
  3268.      
  3269.      DEFAULT
  3270.           KEEP
  3271.      
  3272.      SEE ALSO
  3273.           FILE, FFILE, SAVE, SSAVE
  3274.      
  3275.      STATUS
  3276.           Complete.
  3277.  
  3278.  
  3279.  
  3280.      --------------------------------------------------------------------------
  3281.      COMMAND
  3282.           beep - turn on or off the audible alarm when displaying errors
  3283.      
  3284.      SYNTAX
  3285.           [SET] BEEP ON|OFF
  3286.      
  3287.      DESCRIPTION
  3288.           The BEEP command allows the user to determine if an audible alarm
  3289.           is sounded when an error is displayed.
  3290.      
  3291.      COMPATIBILITY
  3292.           XEDIT: N/A
  3293.           KEDIT: Compatible.
  3294.      
  3295.      DEFAULT
  3296.           OFF
  3297.      
  3298.      STATUS
  3299.           Complete.
  3300.  
  3301.  
  3302.  
  3303.      --------------------------------------------------------------------------
  3304.      COMMAND
  3305.           case - set case sensitivity parameters
  3306.      
  3307.      SYNTAX
  3308.           [SET] CASE Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore] 
  3309.                      [Respect|Ignore]
  3310.      
  3311.      DESCRIPTION
  3312.           The CASE command sets the editor's handling of the case of text.
  3313.      
  3314.           The first option (which is mandatory) controls how text is entered
  3315.           by the user. When LOWER or UPPER are in effect, the shift or caps
  3316.           lock keys have no effect on the text being entered. When MIXED is
  3317.           in effect, text is entered in the case set by the use of the shift
  3318.           and caps lock keys.
  3319.      
  3320.           The second option determines how the editor determines if a string
  3321.           target matches text in the file when the target is used in a LOCATE
  3322.           command.  With IGNORE in effect, a match is
  3323.           found irrespective of the case of the target or the found text.
  3324.           The following strings are treated as equivalent: the THE The ThE...
  3325.           With RESPECT in effect, the target and text must be the same case.
  3326.           Therefore a target of 'The' only matches text containing 'The', not
  3327.           'THE' or 'ThE' etc.
  3328.      
  3329.           The third option determines how the editor determines if a string
  3330.           target matches text in the file when the target is used in a CHANGE
  3331.           command.  With IGNORE in effect, a match is
  3332.           found irrespective of the case of the target or the found text.
  3333.           The following strings are treated as equivalent: the THE The ThE...
  3334.           With RESPECT in effect, the target and text must be the same case.
  3335.           Therefore a target of 'The' only matches text containing 'The', not
  3336.           'THE' or 'ThE' etc.
  3337.      
  3338.           The fourth option determines how the editor determines the sort 
  3339.           order of upper and lower case with the SORT command.
  3340.           With IGNORE in effect, upper and lower case letters are treated as
  3341.           equivalent.
  3342.           With RESPECT in effect, upper and lower case letters are treated as
  3343.           different values and uppercase characters will sort before lowercase
  3344.           characters.
  3345.      
  3346.      COMPATIBILITY
  3347.           XEDIT: Adds support for case significance in CHANGE commands.
  3348.           KEDIT: Adds support for LOWER option.
  3349.           Both:  Adds support for case significance in SORT command.
  3350.      
  3351.      DEFAULT
  3352.           MIXED IGNORE RESPECT RESPECT
  3353.      
  3354.      STATUS
  3355.           Complete
  3356.  
  3357.  
  3358.  
  3359.      --------------------------------------------------------------------------
  3360.      COMMAND
  3361.           clearscreen - indicate if the screen is to be cleared on exit
  3362.      
  3363.      SYNTAX
  3364.           [SET] CLEARScreen ON|OFF
  3365.      
  3366.      DESCRIPTION
  3367.           The CLEARSCREEN command allows the user to request that the 
  3368.           screen be cleared on exit from THE.
  3369.      
  3370.      COMPATIBILITY
  3371.           XEDIT: N/A
  3372.           KEDIT: N/A
  3373.      
  3374.      DEFAULT
  3375.           OFF
  3376.      
  3377.      STATUS
  3378.           Complete
  3379.  
  3380.  
  3381.  
  3382.      --------------------------------------------------------------------------
  3383.      COMMAND
  3384.           clock - turn on or off display of time on status line
  3385.      
  3386.      SYNTAX
  3387.           [SET] CLOCK ON|OFF
  3388.      
  3389.      DESCRIPTION
  3390.           The CLOCK command turns on or off the display of the time on the
  3391.           status line.
  3392.      
  3393.      COMPATIBILITY
  3394.           XEDIT: N/A
  3395.           KEDIT: Compatible.
  3396.      
  3397.      DEFAULT
  3398.           ON
  3399.      
  3400.      STATUS
  3401.           Complete
  3402.  
  3403.  
  3404.  
  3405.      --------------------------------------------------------------------------
  3406.      COMMAND
  3407.           cmdarrows - sets the behaviour of the up and down arrow keys
  3408.      
  3409.      SYNTAX
  3410.           [SET] CMDArrows Retrieve|Tab 
  3411.      
  3412.      DESCRIPTION
  3413.           The CMDARROWS command determines the action that occurs when the
  3414.           up and down arrows keys are hit while on the command line.
  3415.      
  3416.           CMDARROWS RETRIEVE (the default) will set the up and down arrows 
  3417.           to retrieve the last or next command entered on the command 
  3418.           line.
  3419.      
  3420.           CMDARROWS TAB will set the up and down arrows to move to the last 
  3421.           or first line respectively of the main window.
  3422.      
  3423.      COMPATIBILITY
  3424.           XEDIT: N/A
  3425.           KEDIT: N/A
  3426.      
  3427.      DEFAULT
  3428.           RETRIEVE
  3429.      
  3430.      SEE ALSO
  3431.           CURSOR
  3432.      
  3433.      STATUS
  3434.           Complete.
  3435.  
  3436.  
  3437.  
  3438.      --------------------------------------------------------------------------
  3439.      COMMAND
  3440.           cmdline - sets the position of the command line.
  3441.      
  3442.      SYNTAX
  3443.           [SET] CMDline ON|OFF|Top|Bottom
  3444.      
  3445.      DESCRIPTION
  3446.           The CMDLINE command sets the position of the command line, either
  3447.           at the top of the screen, the bottom of the screen or off.
  3448.      
  3449.      COMPATIBILITY
  3450.           XEDIT: Compatible.
  3451.                  CMDLINE ON is equivalent to CMDLINE BOTTOM
  3452.           KEDIT: Compatible. 
  3453.      
  3454.      DEFAULT
  3455.           BOTTOM
  3456.      
  3457.      STATUS
  3458.           Complete.
  3459.  
  3460.  
  3461.  
  3462.      --------------------------------------------------------------------------
  3463.      COMMAND
  3464.           colour - set colours for display
  3465.      
  3466.      SYNTAX
  3467.           [SET] COLOUR area [modifier[...]] [foreground background]
  3468.           [SET] COLOR  area [modifier[...]] [foreground background]
  3469.      
  3470.      DESCRIPTION
  3471.           The COLOUR command changes the colours or display attributes of
  3472.           various display areas in THE.
  3473.      
  3474.           Valid values for 'area':
  3475.             Arrow    - command line prompt
  3476.             Block    - marked block
  3477.             CBlock   - current line if in marked block
  3478.             Cmdline  - command line
  3479.             CTofeof  - as above if the same as current line
  3480.             CUrline  - the current line
  3481.             Divider  - dividing line between vertical split screens
  3482.             Filearea - area containing file lines
  3483.             Idline   - line containing file specific info
  3484.             Msgline  - error messages
  3485.             Pending  - pending commands in prefix
  3486.             PRefix   - prefix area
  3487.             Reserved - any reserved lines
  3488.             Scale    - line showing scale line
  3489.             SHadow   - hidden line marker lines
  3490.             STatarea - line showing status of editing session
  3491.             Tabline  - line showing tab positions
  3492.             TOfeof   - *** Top of File *** and *** Bottom of File *** lines
  3493.      
  3494.           Valid values for 'foreground' and 'background':
  3495.             black,blue,green,cyan,red,magenta,yellow,white
  3496.      
  3497.           Valid values for 'modifier':
  3498.             normal,blink,bold,bright,high,reverse,underline
  3499.      
  3500.           It is an error to attempt to set a colour on a mono display.
  3501.      
  3502.      COMPATIBILITY
  3503.           XEDIT: Functionally compatible. See below.
  3504.           KEDIT: Functionally compatible. See below.
  3505.           Does not implement all modifiers.
  3506.      
  3507.      DEFAULT
  3508.           Depends on compatibility mode setting.
  3509.      
  3510.      SEE ALSO
  3511.           SET COMPAT
  3512.      
  3513.      STATUS  
  3514.           Complete.
  3515.  
  3516.  
  3517.  
  3518.      --------------------------------------------------------------------------
  3519.      COMMAND
  3520.           compat - set compatibility mode
  3521.      
  3522.      SYNTAX
  3523.           [SET] COMPat The|Xedit|Kedit
  3524.      
  3525.      DESCRIPTION
  3526.           The COMPAT command changes some settings of THE to make it 
  3527.           more compatible with the behaviour of XEDIT and KEDIT.
  3528.      
  3529.           This command is most useful as the first [SET] command in a
  3530.           profile file. It will change the default settings of THE to
  3531.           initially look like the chosen editor. You can then make any
  3532.           additional changes in THE by issuing other [SET] commands.
  3533.      
  3534.      COMPATIBILITY
  3535.           XEDIT: N/A
  3536.           KEDIT: N/A
  3537.      
  3538.      DEFAULT
  3539.           THE
  3540.      
  3541.      STATUS  
  3542.           Complete.
  3543.  
  3544.  
  3545.  
  3546.      --------------------------------------------------------------------------
  3547.      COMMAND
  3548.           curline - set position of current line on screen
  3549.      
  3550.      SYNTAX
  3551.           [SET] CURLine M[+n|-n] | [+|-]n
  3552.      
  3553.      DESCRIPTION
  3554.           The CURLINE command sets the position of the current line to
  3555.           the physical screen line specified by supplied arguments.
  3556.      
  3557.           The two forms of parameters are:
  3558.           M[+n|-n] - this sets the current line to be relative to the
  3559.                      middle of the screen. A positvie value adds to the
  3560.                      middle line number, a negative subtracts from it.
  3561.                      eg. M+3 on a 24 line screen will be line 15
  3562.                          M-5 on a 24 line screen will be line 7
  3563.      
  3564.           [+|-]n   - this sets the current line to be relative to the
  3565.                      top of the screen (if positive or no sign) or
  3566.                      relative to the bottom of the screen if negative.
  3567.                      eg. +3 or 3 will set current line to line 3
  3568.                          -3 on a 24 line screen will be line 21
  3569.      
  3570.           If the resulting line is outside the bounds of the screen
  3571.           the position of the current line will become the middle line
  3572.           on the screen.
  3573.      
  3574.      COMPATIBILITY
  3575.           XEDIT: Compatible.
  3576.           KEDIT: Compatible.
  3577.      
  3578.      DEFAULT
  3579.           +6
  3580.      
  3581.      STATUS
  3582.           Complete.
  3583.  
  3584.  
  3585.  
  3586.      --------------------------------------------------------------------------
  3587.      COMMAND
  3588.           dirinclude - set the file mask for directory command
  3589.      
  3590.      SYNTAX
  3591.           [SET] DIRInclude * 
  3592.           [SET] DIRInclude [Normal] [Readonly] [System] [Hidden] [Directory]
  3593.      
  3594.      DESCRIPTION
  3595.           The DIRINCLUDE command sets the file mask for files that will be
  3596.           displayed on subsequent DIRECTORY commands. The operand "*" will
  3597.           set the mask to all files, the other options will set the
  3598.           mask to include those options specified together with "normal"
  3599.           files eg.
  3600.      
  3601.            DIRINCLUDE R S
  3602.      
  3603.           will display readonly and system files together with "normal" files
  3604.           the next time the DIRECTORY command is issued.
  3605.      
  3606.           The effects of DIRINCLUDE are ignored in the Unix version.
  3607.      
  3608.      COMPATIBILITY
  3609.           XEDIT: N/A
  3610.           KEDIT: N/A
  3611.      
  3612.      DEFAULT
  3613.           *
  3614.      
  3615.      SEE ALSO
  3616.           DIRECTORY, LS
  3617.      
  3618.      STATUS
  3619.           Complete.
  3620.  
  3621.  
  3622.  
  3623.      --------------------------------------------------------------------------
  3624.      COMMAND
  3625.           display - specify which level of lines to display
  3626.      
  3627.      SYNTAX
  3628.           [SET] DISPlay n [m|*]
  3629.      
  3630.      DESCRIPTION
  3631.           The DISPLAY command sets the selection level for lines to be
  3632.           displayed on the screen.
  3633.      
  3634.      COMPATIBILITY
  3635.           XEDIT: Compatible.
  3636.           KEDIT: Compatible.
  3637.      
  3638.      DEFAULT
  3639.           0 0
  3640.      
  3641.      SEE ALSO
  3642.           SET SCOPE, SET SELECT, ALL
  3643.      
  3644.      STATUS
  3645.           Complete.
  3646.  
  3647.  
  3648.  
  3649.      --------------------------------------------------------------------------
  3650.      COMMAND
  3651.           eolout - set end of line terminating character(s)
  3652.      
  3653.      SYNTAX
  3654.           [SET] EOLout CRLF|LF
  3655.      
  3656.      DESCRIPTION
  3657.           The EOLOUT command allows the user to specify the combination of
  3658.           characters that terminate a line. Lines of text in Unix files are
  3659.           usually terminated with a LF, whereas in DOS they usually end with
  3660.           a CR and LF combination.
  3661.      
  3662.      COMPATIBILITY
  3663.           XEDIT: N/A
  3664.           KEDIT: N/A
  3665.      
  3666.      DEFAULT
  3667.           LF - Unix, CRLF - DOS/OS2
  3668.      
  3669.      STATUS
  3670.           Complete.
  3671.  
  3672.  
  3673.  
  3674.      --------------------------------------------------------------------------
  3675.      COMMAND
  3676.           etmode - indicate if extended display mode is possible
  3677.      
  3678.      SYNTAX
  3679.           [SET] ETMODE ON|OFF
  3680.      
  3681.      DESCRIPTION
  3682.           The ETMODE command allows the user to specify if extended ASCII
  3683.           codes ( > 127) are to be displayed or should be displayed as
  3684.           the NONDISP character.
  3685.      
  3686.      COMPATIBILITY
  3687.           XEDIT: Similar function but deals with Double-Byte characters
  3688.           KEDIT: N/A
  3689.      
  3690.      DEFAULT
  3691.           ON - DOS/OS2, OFF - Unix
  3692.      
  3693.      SEE ALSO
  3694.           SET NONDISP
  3695.      
  3696.      STATUS
  3697.           Complete.
  3698.  
  3699.  
  3700.  
  3701.      --------------------------------------------------------------------------
  3702.      COMMAND
  3703.           hex - set how hexidecimal strings are treated in string operands
  3704.      
  3705.      SYNTAX
  3706.           [SET] HEX ON|OFF
  3707.      
  3708.      DESCRIPTION
  3709.           The HEX set command determines whether hexidecimal strings are
  3710.           treated as such in string operands.
  3711.           With HEX ON, any string operand of the form
  3712.              /x'31 32 33'/ or
  3713.              /d'49 50 51'/
  3714.           will be converted to /123/ before the command is executed.
  3715.           With HEX OFF, no conversion is done.
  3716.      
  3717.           This conversion should work wherever a string operand is used
  3718.           in any command.
  3719.      
  3720.      COMPATIBILITY
  3721.           XEDIT: Adds support for decimal representation. See below.
  3722.           KEDIT: Compatible. See below.
  3723.           Spaces must seperate each character representation.
  3724.      
  3725.      DEFAULT
  3726.           OFF
  3727.      
  3728.      STATUS
  3729.           Complete.
  3730.  
  3731.  
  3732.  
  3733.      --------------------------------------------------------------------------
  3734.      COMMAND
  3735.           hexdisplay - turn on or off display of character under cursor
  3736.      
  3737.      SYNTAX
  3738.           [SET] HEXDISPlay ON|OFF
  3739.      
  3740.      DESCRIPTION
  3741.           The HEXDISPLAY command turns on or off the display of the character under
  3742.           the cursor on the status line.
  3743.      
  3744.      COMPATIBILITY
  3745.           XEDIT: N/A
  3746.           KEDIT: Compatible.
  3747.      
  3748.      DEFAULT
  3749.           ON
  3750.      
  3751.      STATUS
  3752.           Complete
  3753.  
  3754.  
  3755.  
  3756.      --------------------------------------------------------------------------
  3757.      COMMAND
  3758.           hexshow - turn on or off hex display of current line
  3759.      
  3760.      SYNTAX
  3761.           [SET] HEXShow ON|OFF [M[+n|-n]|[+|-]n]
  3762.      
  3763.      DESCRIPTION
  3764.           The HEXShow command indicates if and where a hexidecimal
  3765.           representation of the current line will be displayed.
  3766.      
  3767.           The two forms of the position parameters are:
  3768.           M[+n|-n] - this sets the hexshow line to be relative to the
  3769.                      middle of the screen. A positive value adds to the
  3770.                      middle line number, a negative subtracts from it.
  3771.                      eg. M+3 on a 24 line screen will be line 15
  3772.                          M-5 on a 24 line screen will be line 7
  3773.      
  3774.           [+|-]n   - this sets the hexshow line to be relative to the
  3775.                      top of the screen (if positive or no sign) or
  3776.                      relative to the bottom of the screen if negative.
  3777.                      eg. +3 or 3 will set scale line to line 3
  3778.                          -3 on a 24 line screen will be line 21
  3779.      
  3780.           If the resulting line is outside the bounds of the screen
  3781.           the position of the hexshow line will become the middle line
  3782.           on the screen.
  3783.      
  3784.           The position argument specifies the position of the first line
  3785.           of the hexidecimal display.
  3786.      
  3787.      COMPATIBILITY
  3788.           XEDIT: N/A
  3789.           KEDIT: N/A
  3790.      
  3791.      DEFAULT
  3792.           OFF 7
  3793.      
  3794.      STATUS
  3795.           Complete
  3796.  
  3797.  
  3798.  
  3799.      --------------------------------------------------------------------------
  3800.      COMMAND
  3801.           idline - specify if IDLINE is displayed
  3802.      
  3803.      SYNTAX
  3804.           [SET] IDline ON|OFF
  3805.      
  3806.      DESCRIPTION
  3807.           The IDLINE set command determines if the IDLINE for a file is
  3808.           displayed or not.
  3809.      
  3810.      COMPATIBILITY
  3811.           XEDIT: N/A
  3812.           KEDIT: Compatible.
  3813.      
  3814.      DEFAULT
  3815.           ON
  3816.      
  3817.      STATUS
  3818.           Complete
  3819.  
  3820.  
  3821.  
  3822.      --------------------------------------------------------------------------
  3823.      COMMAND
  3824.           impcmscp - set implied operating system command processing
  3825.      
  3826.      SYNTAX
  3827.           [SET] IMPcmscp ON|OFF
  3828.      
  3829.      DESCRIPTION
  3830.           The IMPCMSCP command is used to toggle implied operating system
  3831.           command processing from the command line. By turning this feature 
  3832.           on you can then issue an operating system command without the need 
  3833.           to prefix the operating system command with the OS command.
  3834.      
  3835.      COMPATIBILITY
  3836.           XEDIT: Compatible.
  3837.           KEDIT: N/A
  3838.      
  3839.      DEFAULT
  3840.           ON
  3841.      
  3842.      SEE ALSO
  3843.           SET IMPOS
  3844.      
  3845.      STATUS
  3846.           Complete.
  3847.  
  3848.  
  3849.  
  3850.      --------------------------------------------------------------------------
  3851.      COMMAND
  3852.           impmacro - set implied macro command processing
  3853.      
  3854.      SYNTAX
  3855.           [SET] IMPMACro ON|OFF
  3856.      
  3857.      DESCRIPTION
  3858.           The IMPMACRO command is used to toggle implied macro processing
  3859.           from the command line. By turning this feature on you can then
  3860.           issue a macro command without the need to prefix the macro name
  3861.           with the MACRO command.
  3862.      
  3863.      COMPATIBILITY
  3864.           XEDIT: N/A
  3865.           KEDIT: Compatible.
  3866.      
  3867.      DEFAULT
  3868.           ON
  3869.      
  3870.      SEE ALSO
  3871.           MACRO, SET MACROPATH
  3872.      
  3873.      STATUS
  3874.           Complete.
  3875.  
  3876.  
  3877.  
  3878.      --------------------------------------------------------------------------
  3879.      COMMAND
  3880.           impos - set implied operating system command processing
  3881.      
  3882.      SYNTAX
  3883.           [SET] IMPOS ON|OFF
  3884.      
  3885.      DESCRIPTION
  3886.           The IMPOS command is used to toggle implied operating system
  3887.           command processing from the command line. By turning this feature 
  3888.           on you can then issue an operating system command without the need 
  3889.           to prefix the operating system command with the OS command.
  3890.      
  3891.      COMPATIBILITY
  3892.           XEDIT: Compatible.
  3893.           KEDIT: N/A
  3894.      
  3895.      DEFAULT
  3896.           ON
  3897.      
  3898.      SEE ALSO
  3899.           SET IMPCMSCP
  3900.      
  3901.      STATUS
  3902.           Complete.
  3903.  
  3904.  
  3905.  
  3906.      --------------------------------------------------------------------------
  3907.      COMMAND
  3908.           insertmode - put editor into or out of insert mode
  3909.      
  3910.      SYNTAX
  3911.           [SET] INSERTMode ON|OFF|TOGGLE
  3912.      
  3913.      DESCRIPTION
  3914.           The INSERTMODE command toggles the insert mode within THE.
  3915.      
  3916.      COMPATIBILITY
  3917.           XEDIT: N/A
  3918.           KEDIT: Compatible.
  3919.      
  3920.      DEFAULT
  3921.           OFF
  3922.      
  3923.      STATUS
  3924.           Complete.
  3925.  
  3926.  
  3927.  
  3928.      --------------------------------------------------------------------------
  3929.      COMMAND
  3930.           linend - allow/disallow multiple commands on command line
  3931.      
  3932.      SYNTAX
  3933.           [SET] LINENd ON|OFF [char]
  3934.      
  3935.      DESCRIPTION
  3936.           The LINEND command allows or disallows the execution of multiple
  3937.           commands on the command line. When setting LINEND ON, a character
  3938.           is specified as the LINEND character which delimits each command.
  3939.      
  3940.      COMPATIBILITY
  3941.           XEDIT: Compatible.
  3942.           KEDIT: Compatible.
  3943.      
  3944.      DEFAULT
  3945.           OFF #
  3946.      
  3947.      STATUS
  3948.           Complete.
  3949.  
  3950.  
  3951.  
  3952.      --------------------------------------------------------------------------
  3953.      COMMAND
  3954.           macroext - set default macro extension value
  3955.      
  3956.      SYNTAX
  3957.           [SET] MACROExt [ext]
  3958.      
  3959.      DESCRIPTION
  3960.           The MACROEXT command sets the value of the file extension to be
  3961.           used for macro files. When a macro file name is specified on the
  3962.           command line, a fullstop '.' then this value will be appended.
  3963.           If no value is specified for ext, then THE assumes that the
  3964.           supplied macro file name is the fully specified name for a macro.
  3965.      
  3966.           The length of ext must be 10 characters or less.
  3967.      
  3968.           The macro extension is only appended to a file if that file does
  3969.           not include any path specifiers.
  3970.      
  3971.      COMPATIBILITY
  3972.           XEDIT: N/A
  3973.           KEDIT: N/A
  3974.      
  3975.      DEFAULT
  3976.           the
  3977.      
  3978.      STATUS
  3979.           Complete.
  3980.  
  3981.  
  3982.  
  3983.      --------------------------------------------------------------------------
  3984.      COMMAND
  3985.           macropath - set default path for macro commands
  3986.      
  3987.      SYNTAX
  3988.           [SET] MACROPath path[s]
  3989.      
  3990.      DESCRIPTION
  3991.           The MACROPATH command sets up the search path from which macro
  3992.           command files are executed. Each directory is seperated by a
  3993.           colon (Unix) or semi-colon (DOS & OS/2).
  3994.           No check is done at this stage to validate the supplied path.
  3995.      
  3996.      COMPATIBILITY
  3997.           XEDIT: N/A
  3998.           KEDIT: Incompatible.
  3999.      
  4000.      DEFAULT
  4001.           Path specified by env variable THE_MACRO_PATH
  4002.      
  4003.      SEE ALSO
  4004.           MACRO, SET IMPMACRO
  4005.      
  4006.      STATUS
  4007.           Complete.
  4008.  
  4009.  
  4010.  
  4011.      --------------------------------------------------------------------------
  4012.      COMMAND
  4013.           margins - set left and right margins for wordwrap
  4014.      
  4015.      SYNTAX
  4016.           [SET] MARgins left right [[+|-]indent]
  4017.      
  4018.      DESCRIPTION
  4019.           The MARGINS command sets the left and right margins and the
  4020.           number of columns to indent a paragraph.
  4021.           These values are used with the WORDWRAP option.
  4022.      
  4023.      COMPATIBILITY
  4024.           XEDIT: N/A
  4025.           KEDIT: Compatible.
  4026.      
  4027.      DEFAULT
  4028.           1 72 +0
  4029.      
  4030.      SEE ALSO
  4031.           SET WORDWRAP
  4032.      
  4033.      STATUS
  4034.           Complete.
  4035.  
  4036.  
  4037.  
  4038.      --------------------------------------------------------------------------
  4039.      COMMAND
  4040.           msgline - set position and size of message line
  4041.      
  4042.      SYNTAX
  4043.           [SET] MSGLine ON [M[+n|-n]|[+|-]n] [lines]
  4044.      
  4045.      DESCRIPTION
  4046.           The MSGLINE set command specifies the position of the message line
  4047.           and the size of the message line window.
  4048.      
  4049.           The two forms of the position parameters are:
  4050.           M[+n|-n] - this sets the first line to be relative to the
  4051.                      middle of the screen. A positive value adds to the
  4052.                      middle line number, a negative subtracts from it.
  4053.                      eg. M+3 on a 24 line screen will be line 15
  4054.                          M-5 on a 24 line screen will be line 7
  4055.      
  4056.           [+|-]n   - this sets the first line to be relative to the
  4057.                      top of the screen (if positive or no sign) or
  4058.                      relative to the bottom of the screen if negative.
  4059.                      eg. +3 or 3 will set tab line to line 3
  4060.                          -3 on a 24 line screen will be line 21
  4061.      
  4062.           If the resulting line is outside the bounds of the screen
  4063.           the position of the message line will become the middle line
  4064.           on the screen.
  4065.      
  4066.      COMPATIBILITY
  4067.           XEDIT: Compatible.
  4068.                  Does not support OVERLAY option.
  4069.           KEDIT: Compatible
  4070.                  Does not support OVERLAY option.
  4071.      
  4072.      DEFAULT
  4073.           ON 2 1
  4074.      
  4075.      STATUS
  4076.           Complete
  4077.  
  4078.  
  4079.  
  4080.      --------------------------------------------------------------------------
  4081.      COMMAND
  4082.           msgmode - set display of messages on or off
  4083.      
  4084.      SYNTAX
  4085.           [SET] MSGMode ON|OFF
  4086.      
  4087.      DESCRIPTION
  4088.           The MSGMODE set command determines whether error messages will be 
  4089.           displayed or suppressed.
  4090.      
  4091.      COMPATIBILITY
  4092.           XEDIT: Does not support [Short|Long] options.
  4093.           KEDIT: Compatible
  4094.      
  4095.      DEFAULT
  4096.           ON
  4097.      
  4098.      STATUS
  4099.           Complete
  4100.  
  4101.  
  4102.  
  4103.      --------------------------------------------------------------------------
  4104.      COMMAND
  4105.           newlines - set position of cursor after adding blank line
  4106.      
  4107.      SYNTAX
  4108.           [SET] NEWLines Aligned|Left
  4109.      
  4110.      DESCRIPTION
  4111.           The NEWLINES set command determines where the cursor displays after
  4112.           a new line is added to the file.
  4113.           With ALIGNED, the cursor will display in the column of the new line
  4114.           immediately underneath the first non-blank character in the line
  4115.           above.
  4116.           With LEFT, the cursor will display in the first column of the new line.
  4117.      
  4118.      COMPATIBILITY
  4119.           XEDIT: N/A
  4120.           KEDIT: Same command, different functionality.
  4121.      
  4122.      DEFAULT
  4123.           ALIGNED
  4124.      
  4125.      STATUS
  4126.           Complete
  4127.  
  4128.  
  4129.  
  4130.      --------------------------------------------------------------------------
  4131.      COMMAND
  4132.           nondisp - specify character to display for non-displaying characters
  4133.      
  4134.      SYNTAX
  4135.           [SET] NONDisp char
  4136.      
  4137.      DESCRIPTION
  4138.           The NONDISP command allows the user to change the character that 
  4139.           is displayed for non-displaying commands when [SET] ETMODE is OFF.
  4140.      
  4141.      COMPATIBILITY
  4142.           XEDIT: Compatible.
  4143.           KEDIT: N/A
  4144.      
  4145.      DEFAULT
  4146.           #
  4147.      
  4148.      SEE ALSO
  4149.           SET ETMODE
  4150.      
  4151.      STATUS
  4152.           Complete.
  4153.  
  4154.  
  4155.  
  4156.      --------------------------------------------------------------------------
  4157.      COMMAND
  4158.           number - turn prefix numbers on or off
  4159.      
  4160.      SYNTAX
  4161.           [SET] NUMber ON|OFF
  4162.      
  4163.      DESCRIPTION
  4164.           The NUMBER command allows the user to toggle the display of numbers
  4165.           in the prefix area.
  4166.      
  4167.      COMPATIBILITY
  4168.           XEDIT: Compatible.
  4169.           KEDIT: Compatible.
  4170.      
  4171.      DEFAULT
  4172.           ON
  4173.      
  4174.      SEE ALSO
  4175.           SET PREFIX
  4176.      
  4177.      STATUS
  4178.           Complete.
  4179.  
  4180.  
  4181.  
  4182.      --------------------------------------------------------------------------
  4183.      COMMAND
  4184.           pending - set status of pending prefix commands
  4185.      
  4186.      SYNTAX
  4187.           [SET] PENDing ON string
  4188.           [SET] PENDing OFF
  4189.           [SET] PENDing BLOCK string
  4190.      
  4191.      DESCRIPTION
  4192.           The PENDING command allows the user to insert or remove commands
  4193.           from the pending prefix list.
  4194.      
  4195.           ON string, simulates the user typing 'string' in the PREFIX area
  4196.           of the focus line.
  4197.      
  4198.           OFF, removes any pending prefix command from the focus line.
  4199.      
  4200.           BLOCK string, simulates the user typing 'string' in the PREFIX
  4201.           area of the focus line and identifies the prefix command to be 
  4202.           a BLOCK command.
  4203.      
  4204.      COMPATIBILITY
  4205.           XEDIT: Does not support ERROR option.
  4206.           KEDIT: N/A
  4207.      
  4208.      STATUS
  4209.           Complete.
  4210.  
  4211.  
  4212.  
  4213.      --------------------------------------------------------------------------
  4214.      COMMAND
  4215.           point - assign a name to the current line
  4216.      
  4217.      SYNTAX
  4218.           [SET] Point .name [OFF]
  4219.      
  4220.      DESCRIPTION
  4221.           The POINT command assignes the specified name to the current
  4222.           line, or removes the name from the line with the specified name.
  4223.           A valid line name must start with a '.' followed by an alphabetic
  4224.           character. eg. .a .fred and .GG are valid names; fred and .3 are
  4225.           invalid line names.
  4226.      
  4227.           When a line is moved within the same file, its line name stays
  4228.           with the line.
  4229.      
  4230.      COMPATIBILITY
  4231.           XEDIT: Compatible. See below.
  4232.           KEDIT: Compatible. See below.
  4233.           Does not allow for multiple names for the same line.
  4234.      
  4235.      STATUS
  4236.           Complete.
  4237.  
  4238.  
  4239.  
  4240.      --------------------------------------------------------------------------
  4241.      COMMAND
  4242.           position - determine if LINE/COL is displayed on IDLINE
  4243.      
  4244.      SYNTAX
  4245.           [SET] POSition ON|OFF
  4246.      
  4247.      DESCRIPTION
  4248.           The POSITION command allows the user to turn on or off the
  4249.           display of LINE/COL on the IDLINE.
  4250.      
  4251.      COMPATIBILITY
  4252.           XEDIT: N/A
  4253.           KEDIT: N/A
  4254.      
  4255.      DEFAULT
  4256.           ON
  4257.      
  4258.      STATUS
  4259.           Complete.
  4260.  
  4261.  
  4262.  
  4263.      --------------------------------------------------------------------------
  4264.      COMMAND
  4265.           prefix - set prefix area attributes
  4266.      
  4267.      SYNTAX
  4268.           [SET] PREfix ON [Left|Right]
  4269.           [SET] PREfix Nulls [Left|Right]
  4270.           [SET] PREfix OFF
  4271.           [SET] PREfix Synonym newname oldname
  4272.      
  4273.      DESCRIPTION
  4274.           The first form of the PREFIX command allows the user to display
  4275.           the prefix area and optionally to select the position the prefix
  4276.           should be displayed at.
  4277.      
  4278.           The second form of the PREFIX command is functionally the same
  4279.           as the first form. The difference is that when the prefix area
  4280.           is displayed with NUMBER ON, numbers are displyed with leading
  4281.           spaces rather than zeros; with NUMBER OFF, blanks are displayed
  4282.           instead of equal signs.
  4283.      
  4284.           The third form, turns the display of the prefix area off.
  4285.           Executed from within the profile, the only effect is that the
  4286.           defaults for all files is changed.
  4287.           Executed from the command line, the PREFIX command changes the
  4288.           current window displays to reflect the required options.
  4289.      
  4290.           The fourth form of the PREFIX command allows the users to specify
  4291.           a synonym for a prefix command or REXX prefix macro. The 'newname'
  4292.           is the command entered in the prefix area and 'oldname' corresponds
  4293.           to an existing prefix command or a REXX macro file in the MACROPATH
  4294.           ending in .the or whatever the value of MACROEXT is at the time the
  4295.           prefix command is executed. The 'oldname' can also be the fully
  4296.           qualified filename of a REXX macro.
  4297.      
  4298.      COMPATIBILITY
  4299.           XEDIT: Compatible. See below.
  4300.           KEDIT: Compatible. See below.
  4301.      
  4302.      DEFAULT
  4303.           ON LEFT
  4304.      
  4305.      STATUS
  4306.           Complete.
  4307.  
  4308.  
  4309.  
  4310.      --------------------------------------------------------------------------
  4311.      COMMAND
  4312.           printer - define printer spooler name
  4313.      
  4314.      SYNTAX
  4315.           [SET] PRINTER spooler
  4316.      
  4317.      DESCRIPTION
  4318.           The PRINTER command sets up the print spooler name to determine
  4319.           where output from the PRINT command goes.
  4320.      
  4321.      COMPATIBILITY
  4322.           XEDIT: N/A
  4323.           KEDIT: Compatible.
  4324.      
  4325.      DEFAULT
  4326.           LPT1 - DOS/OS2, lpr - Unix
  4327.      
  4328.      SEE ALSO
  4329.           PRINT
  4330.      
  4331.      STATUS
  4332.           Complete. 
  4333.  
  4334.  
  4335.  
  4336.      --------------------------------------------------------------------------
  4337.      COMMAND
  4338.           reprofile - indicate if profile file to be executed for all files
  4339.      
  4340.      SYNTAX
  4341.           [SET] REPROFile ON|OFF
  4342.      
  4343.      DESCRIPTION
  4344.           The REPROFILE command allows the user to determine if the profile
  4345.           file is to reexecuted for files subsequenlty edited.
  4346.      
  4347.      COMPATIBILITY
  4348.           XEDIT: N/A
  4349.           KEDIT: Compatible.
  4350.      
  4351.      DEFAULT
  4352.           OFF
  4353.      
  4354.      SEE ALSO
  4355.           XEDIT
  4356.      
  4357.      STATUS
  4358.           Complete
  4359.  
  4360.  
  4361.  
  4362.      --------------------------------------------------------------------------
  4363.      COMMAND
  4364.           reserved - display a reserved line
  4365.      
  4366.      SYNTAX
  4367.           [SET] RESERved +|-n [colour] text|OFF
  4368.      
  4369.      DESCRIPTION
  4370.           The RESERVED command reseves a line for the display of arbitrary
  4371.           text by the user. The position is determined by +|-n.
  4372.           This number, if positive, specifies the line relative from the
  4373.           top of the display. A negative number is relative from the
  4374.           bottom of the display.
  4375.      
  4376.           By specifying a line, say +3, then THREE lines from the top will
  4377.           be reserved, with the supplied text being displayed in line 3.
  4378.      
  4379.           The idline of a file will always be displayed after any reserved
  4380.           lines.
  4381.      
  4382.           The status area will always be displayed on the very last line
  4383.           of the screen and any reserved lines will display above that.
  4384.           The status area then is effectively line -0.
  4385.      
  4386.           The colour option specifies the colours to use to display the
  4387.           reserved line.
  4388.      
  4389.      COMPATIBILITY
  4390.           XEDIT: Compatible.
  4391.           KEDIT: Compatible.
  4392.      
  4393.      SEE ALSO
  4394.           SET COLOUR
  4395.      
  4396.      STATUS
  4397.           Complete.
  4398.  
  4399.  
  4400.  
  4401.      --------------------------------------------------------------------------
  4402.      COMMAND
  4403.           rexxoutput - indicate where REXX output is to go
  4404.      
  4405.      SYNTAX
  4406.           [SET] REXXOUTput File|Display n
  4407.      
  4408.      DESCRIPTION
  4409.           The REXXOUTPUT command indicates where output from the REXX
  4410.           interpreter is to go; either captured to a file in the ring
  4411.           or displayed in a scrolling fashion on the screen.
  4412.      
  4413.           Also specified is the maximum number of lines from the REXX
  4414.           interpreter that are to be displayed or captured. This is
  4415.           particularly useful when a REXX macro gets into an infinite
  4416.           loop.
  4417.      
  4418.      COMPATIBILITY
  4419.           XEDIT: N/A
  4420.           KEDIT: N/A
  4421.      
  4422.      DEFAULT
  4423.           DISPLAY 1000
  4424.      
  4425.      STATUS
  4426.           Complete.
  4427.  
  4428.  
  4429.  
  4430.      --------------------------------------------------------------------------
  4431.      COMMAND
  4432.           scale - set position and status of scale line on screen
  4433.      
  4434.      SYNTAX
  4435.           [SET] SCALE ON|OFF [M[+n|-n]|[+|-]n]
  4436.      
  4437.      DESCRIPTION
  4438.           The SCALE command sets the position and status of the scale line
  4439.           for the current view.
  4440.      
  4441.           The two forms of the position parameters are:
  4442.           M[+n|-n] - this sets the scale line to be relative to the
  4443.                      middle of the screen. A positive value adds to the
  4444.                      middle line number, a negative subtracts from it.
  4445.                      eg. M+3 on a 24 line screen will be line 15
  4446.                          M-5 on a 24 line screen will be line 7
  4447.      
  4448.           [+|-]n   - this sets the scale line to be relative to the
  4449.                      top of the screen (if positive or no sign) or
  4450.                      relative to the bottom of the screen if negative.
  4451.                      eg. +3 or 3 will set scale line to line 3
  4452.                          -3 on a 24 line screen will be line 21
  4453.      
  4454.           If the resulting line is outside the bounds of the screen
  4455.           the position of the current line will become the middle line
  4456.           on the screen.
  4457.      
  4458.      COMPATIBILITY
  4459.           XEDIT: Compatible.
  4460.           KEDIT: Compatible.
  4461.      
  4462.      DEFAULT
  4463.           OFF M+1
  4464.      
  4465.      STATUS
  4466.           Complete.
  4467.  
  4468.  
  4469.  
  4470.      --------------------------------------------------------------------------
  4471.      COMMAND
  4472.           scope - sets which lines are to be excluded from commands
  4473.      
  4474.      SYNTAX
  4475.           [SET] SCOPE All|Display
  4476.      
  4477.      DESCRIPTION
  4478.           The SCOPE command indicates whether lines not displayed as
  4479.           the result of a SET DISPLAY or ALL command are included in
  4480.           the scope of lines to be acted upon by other THE commands.
  4481.      
  4482.      COMPATIBILITY
  4483.           XEDIT: Compatible.
  4484.           KEDIT: Compatible.
  4485.      
  4486.      DEFAULT
  4487.           DISPLAY
  4488.      
  4489.      SEE ALSO
  4490.           SET DISPLAY, SET SELECT, ALL
  4491.      
  4492.      STATUS
  4493.           Completed.
  4494.  
  4495.  
  4496.  
  4497.      --------------------------------------------------------------------------
  4498.      COMMAND
  4499.           screen - specifiy number of screens displayed
  4500.      
  4501.      SYNTAX
  4502.           [SET] SCReen n [Horizontal|Vertical]
  4503.      
  4504.      DESCRIPTION
  4505.           The SCREEN command specifies the number of views of file(s) to
  4506.           display on screen at once. If the number of views specified is 2
  4507.           and only one file is currently in the ring, two views of the
  4508.           same file are displayed.
  4509.      
  4510.      COMPATIBILITY
  4511.           XEDIT: Does not support Size,Width or Define options.
  4512.           KEDIT: Does not support Size option.
  4513.           Only 2 screens are supported.
  4514.      
  4515.      DEFAULT
  4516.           1
  4517.      
  4518.      STATUS
  4519.           Complete.
  4520.  
  4521.  
  4522.  
  4523.      --------------------------------------------------------------------------
  4524.      COMMAND
  4525.           select - sets the selection level for the specified lines
  4526.      
  4527.      SYNTAX
  4528.           [SET] SELect [+|-]n [target]
  4529.      
  4530.      DESCRIPTION
  4531.           The SELECT command sets the selection level for the indicated
  4532.           lines equal to n (if no signs are specified) or adds or subtracts
  4533.           n from the selection level currently set for the lines in the
  4534.           target.
  4535.      
  4536.      COMPATIBILITY
  4537.           XEDIT: Compatible.
  4538.           KEDIT: Compatible.
  4539.      
  4540.      DEFAULT
  4541.           0
  4542.      
  4543.      SEE ALSO
  4544.           SET SCOPE, SET DISPLAY, ALL
  4545.      
  4546.      STATUS
  4547.           Complete.
  4548.  
  4549.  
  4550.  
  4551.      --------------------------------------------------------------------------
  4552.      COMMAND
  4553.           shadow - determines if shadow lines are displayed or not
  4554.      
  4555.      SYNTAX
  4556.           [SET] SHADOW ON|OFF
  4557.      
  4558.      DESCRIPTION
  4559.           The SHADOW command indicates whether shadow lines are to be
  4560.           displayed.
  4561.      
  4562.      COMPATIBILITY
  4563.           XEDIT: Compatible.
  4564.           KEDIT: Compatible.
  4565.      
  4566.      DEFAULT
  4567.           ON
  4568.      
  4569.      SEE ALSO
  4570.           SET DISPLAY, SET SELECT, ALL
  4571.      
  4572.      STATUS
  4573.           Completed.
  4574.  
  4575.  
  4576.  
  4577.      --------------------------------------------------------------------------
  4578.      COMMAND
  4579.           statusline - set position of status line
  4580.      
  4581.      SYNTAX
  4582.           [SET] STATUSLine Top|Bottom|Off|GUI
  4583.      
  4584.      DESCRIPTION
  4585.      
  4586.           The STATUSLINE command determines the position of the status
  4587.           line for the editing session. TOP will place the status line on
  4588.           the first line of the screen; BOTTOM will place the status line
  4589.           on the last line of the screen; OFF turns off the display of
  4590.           the status line.
  4591.      
  4592.           The GUI option is only meaningful for those platforms that support
  4593.           a separate status line window. If specified for non-GUI ports, the
  4594.           GUI option is equivalent to OFF.
  4595.      
  4596.      COMPATIBILITY
  4597.           XEDIT: N/A
  4598.           KEDIT: Compatible.
  4599.                  Added GUI option.
  4600.      
  4601.      DEFAULT
  4602.           BOTTOM
  4603.      
  4604.      STATUS
  4605.           Complete
  4606.  
  4607.  
  4608.  
  4609.      --------------------------------------------------------------------------
  4610.      COMMAND
  4611.           stay - set condition of cursor position after CHANGE/LOCATE commands
  4612.      
  4613.      SYNTAX
  4614.           [SET] STAY ON|OFF
  4615.      
  4616.      DESCRIPTION
  4617.           The STAY set command determines what line is displayed as the current
  4618.           line after an unsuccessful LOCATE or successful CHANGE command.
  4619.           With STAY ON, the current line remains where it currently is. With
  4620.           STAY OFF, after an unsuccessful LOCATE, the current line is "Bottom
  4621.           of File". After a successful CHANGE, the current line is the last
  4622.           line affected by the CHANGE command.
  4623.      
  4624.      COMPATIBILITY
  4625.           XEDIT: Compatible.
  4626.           KEDIT: Compatible.
  4627.      
  4628.      DEFAULT
  4629.           ON
  4630.      
  4631.      STATUS
  4632.           Complete
  4633.  
  4634.  
  4635.  
  4636.      --------------------------------------------------------------------------
  4637.      COMMAND
  4638.           synonym - define synonyms for commands
  4639.      
  4640.      SYNTAX
  4641.           [SET] SYNonym ON|OFF
  4642.           [SET] SYNonym [LINEND char] newname [n] oldname
  4643.      
  4644.      DESCRIPTION
  4645.           The SYNONYM command allows the user to define synonyms for commands
  4646.           or macros.
  4647.      
  4648.           The first format indicates if synonym processing is to be performed.
  4649.      
  4650.           The second format specifies the name to be associated with the
  4651.           following commands.
  4652.      
  4653.      COMPATIBILITY
  4654.           XEDIT: Does not support the formatting option.
  4655.           KEDIT: Compatible.
  4656.      
  4657.      DEFAULT
  4658.           ON
  4659.      
  4660.      STATUS
  4661.           Incomplete.
  4662.  
  4663.  
  4664.  
  4665.      --------------------------------------------------------------------------
  4666.      COMMAND
  4667.           tabkey - set characteristics of the SOS TABF command
  4668.      
  4669.      SYNTAX
  4670.           [SET] TABKey Tab|Character Tab|Character
  4671.      
  4672.      DESCRIPTION
  4673.           The TABKEY sets the action to be taken when the SOS TABF command
  4674.           is executed. Depending on the insert mode, the SOS TABF command
  4675.           will either display a raw tab character or will move to the next
  4676.           tab column.
  4677.           The first operand refers to the behaviour of the SOS TABF command
  4678.           when INSERTMODE is OFF; the second operand specifies the behaviour
  4679.           when the SOS TABF command is executed when INSERTMODE is ON.
  4680.      
  4681.      COMPATIBILITY
  4682.           XEDIT: N/A
  4683.           KEDIT: N/A
  4684.      
  4685.      DEFAULT
  4686.           TAB CHARACTER
  4687.      
  4688.      STATUS
  4689.           Complete
  4690.  
  4691.  
  4692.  
  4693.      --------------------------------------------------------------------------
  4694.      COMMAND
  4695.           tabline - set position and status of tab line on screen
  4696.      
  4697.      SYNTAX
  4698.           [SET] TABLine ON|OFF [M[+n|-n]|[+|-]n]
  4699.      
  4700.      DESCRIPTION
  4701.           The TABLINE command sets the position and status of the tab line
  4702.           for the current view.
  4703.      
  4704.           The two forms of the position parameters are:
  4705.           M[+n|-n] - this sets the tab line to be relative to the
  4706.                      middle of the screen. A positive value adds to the
  4707.                      middle line number, a negative subtracts from it.
  4708.                      eg. M+3 on a 24 line screen will be line 15
  4709.                          M-5 on a 24 line screen will be line 7
  4710.      
  4711.           [+|-]n   - this sets the tab line to be relative to the
  4712.                      top of the screen (if positive or no sign) or
  4713.                      relative to the bottom of the screen if negative.
  4714.                      eg. +3 or 3 will set tab line to line 3
  4715.                          -3 on a 24 line screen will be line 21
  4716.      
  4717.           If the resulting line is outside the bounds of the screen
  4718.           the position of the current line will become the middle line
  4719.           on the screen.
  4720.      
  4721.      COMPATIBILITY
  4722.           XEDIT: Compatible.
  4723.           KEDIT: Compatible.
  4724.      
  4725.      DEFAULT
  4726.           OFF -3
  4727.      
  4728.      STATUS
  4729.           Complete.
  4730.  
  4731.  
  4732.  
  4733.      --------------------------------------------------------------------------
  4734.      COMMAND
  4735.           tabs - set tab length for TAB key
  4736.      
  4737.      SYNTAX
  4738.           [SET] TABS n1 n2[n3...n32]
  4739.           [SET] TABS INCR n
  4740.      
  4741.      DESCRIPTION
  4742.           The TABS command determines the position of tab columns when the
  4743.           SOS TABF or SOS TABB commands are executed.
  4744.      
  4745.      COMPATIBILITY
  4746.           XEDIT: Compatible.
  4747.           KEDIT: Compatible.
  4748.      
  4749.      DEFAULT
  4750.           INCR 8
  4751.      
  4752.      SEE ALSO
  4753.           SOS TABF, SOS TABB
  4754.      
  4755.      STATUS
  4756.           Complete.
  4757.  
  4758.  
  4759.  
  4760.      --------------------------------------------------------------------------
  4761.      COMMAND
  4762.           tabsin - set tab processing on file input
  4763.      
  4764.      SYNTAX
  4765.           [SET] TABSIn ON|OFF [n]
  4766.      
  4767.      DESCRIPTION
  4768.           The TABSIN command determines if tabs read from a file are to be
  4769.           expanded to spaces and if so how many spaces.
  4770.      
  4771.      COMPATIBILITY
  4772.           XEDIT: N/A
  4773.           KEDIT: Does not support TABQUOTE option.
  4774.      
  4775.      DEFAULT
  4776.           OFF 8
  4777.      
  4778.      SEE ALSO
  4779.           SET TABSOUT
  4780.      
  4781.      STATUS
  4782.           Complete.
  4783.  
  4784.  
  4785.  
  4786.      --------------------------------------------------------------------------
  4787.      COMMAND
  4788.           tabsout - set tab processing on file output
  4789.      
  4790.      SYNTAX
  4791.           [SET] TABSOut ON|OFF [n]
  4792.      
  4793.      DESCRIPTION
  4794.           The TABSOUT command determines if spaces written to a file are to be
  4795.           compressed to tabs and if so how many spaces.
  4796.      
  4797.      COMPATIBILITY
  4798.           XEDIT: N/A
  4799.           KEDIT: Compatible.
  4800.      
  4801.      DEFAULT
  4802.           OFF 8
  4803.      
  4804.      SEE ALSO
  4805.           SET TABSIN
  4806.      
  4807.      STATUS
  4808.           Complete.
  4809.  
  4810.  
  4811.  
  4812.      --------------------------------------------------------------------------
  4813.      COMMAND
  4814.           typeahead - set behavior of screen redraw
  4815.      
  4816.      SYNTAX
  4817.           [SET] TYPEAhead ON|OFF
  4818.      
  4819.      DESCRIPTION
  4820.           The TYPEAHEAD set command determines whether of not THE uses the
  4821.           curses screen display optimization techniques.
  4822.           With TYPEAHEAD ON, curses will abort screen display if a keystroke
  4823.           is pending.
  4824.           With TYPEAHEAD OFF, curses will not abort screen display if a
  4825.           keystroke is pending.
  4826.           For BSD based curses, this function has no effect.
  4827.      
  4828.      COMPATIBILITY
  4829.           XEDIT: N/A
  4830.           KEDIT: N/A
  4831.      
  4832.      DEFAULT
  4833.           ON
  4834.      
  4835.      STATUS
  4836.           Complete.
  4837.  
  4838.  
  4839.  
  4840.      --------------------------------------------------------------------------
  4841.      COMMAND
  4842.           verify - set column display limits
  4843.      
  4844.      SYNTAX
  4845.           [SET] Verify first [last]
  4846.      
  4847.      DESCRIPTION
  4848.           The VERIFY command sets the column limits for the display of the
  4849.           current file. 'first' specifies the first column to be displayed
  4850.           and 'last' specifies the last column to be displayed.
  4851.      
  4852.           If no 'last' option is specified '*' is assumed.
  4853.      
  4854.      COMPATIBILITY
  4855.           XEDIT: Does not implement HEX display nor multiple column pairs.
  4856.           KEDIT: Does not implement HEX display nor multiple column pairs.
  4857.      
  4858.      DEFAULT
  4859.           1 *
  4860.      
  4861.      SEE ALSO
  4862.           SET ZONE
  4863.      
  4864.      STATUS
  4865.           Complete.
  4866.  
  4867.  
  4868.  
  4869.      --------------------------------------------------------------------------
  4870.      COMMAND
  4871.           wordwrap - set wordwrap feature on or off
  4872.      
  4873.      SYNTAX
  4874.           [SET] WORDWrap ON|OFF
  4875.      
  4876.      DESCRIPTION
  4877.           The WORDWRAP set command determines whether wordwrap occurs when
  4878.           the cursor moves past the right margin (as set my [SET] MARGINS
  4879.           command).
  4880.           With WORDWRAP ON, the line, from the beginning of the word that
  4881.           exceeds the right margin, is wrapped onto the next line. The cursor
  4882.           position stays in the same position relative to the current word.
  4883.           WIth WORDWRAP OFF, no word wrap occurs.
  4884.      
  4885.      COMPATIBILITY
  4886.           XEDIT: N/A
  4887.           KEDIT: Compatible.
  4888.      
  4889.      DEFAULT
  4890.           OFF
  4891.      
  4892.      SEE ALSO
  4893.           SET MARGINS
  4894.      
  4895.      STATUS
  4896.           Complete.
  4897.  
  4898.  
  4899.  
  4900.      --------------------------------------------------------------------------
  4901.      COMMAND
  4902.           zone - set column limits for editing
  4903.      
  4904.      SYNTAX
  4905.           [SET] Zone first [last]
  4906.      
  4907.      DESCRIPTION
  4908.           The ZONE command sets the column limits for various other editor
  4909.           commands, such as 'locate' and 'change'. It effectively restricts
  4910.           to the specified columns those parts of the file which can be
  4911.           acted upon.
  4912.      
  4913.           If no 'last' option is specified '*' is assumed.
  4914.      
  4915.      COMPATIBILITY
  4916.           XEDIT: Compatible.
  4917.           KEDIT: Compatible.
  4918.      
  4919.      DEFAULT
  4920.           1 *
  4921.      
  4922.      SEE ALSO
  4923.           SET VERIFY
  4924.      
  4925.      STATUS
  4926.           Complete.
  4927.  
  4928.  
  4929.  
  4930.      --------------------------------------------------------------------------
  4931.      
  4932.      
  4933.      ========================================================================
  4934.      QUERY, EXTRACT and STATUS
  4935.      ========================================================================
  4936.      
  4937.           The following lists the valid variables that can be queried and
  4938.           also shows what values are returned. For both QUERY and STATUS,
  4939.           the values are concatenated together and displayed as a single
  4940.           line. For EXTRACT the REXX variables that are set are defined.
  4941.           The capitalised portion of the variable is the minimum abbreviation
  4942.           recognised.
  4943.           The bracketed text at the end of the description indicates from
  4944.           which commands a valid response will be supplied (Q-Query,E-Extract
  4945.           M-Modify and S-Status).
  4946.      
  4947.      ALT
  4948.           The number of alterations to the current file since the last SAVE
  4949.           or AUTOSAVE.
  4950.           (QES)
  4951.      
  4952.           alt.0           - 2
  4953.           alt.1           - Number of alterations since last SAVE or AUTOSAVE
  4954.           alt.2           - Number of alterations since last SAVE
  4955.      
  4956.      ARBchar
  4957.           The status of ARBCHAR and the ARBCHAR characters.
  4958.           (QEMS)
  4959.      
  4960.           arbchar.0       - 3
  4961.           arbchar.1       - ON|OFF
  4962.           arbchar.2       - multiple match character
  4963.           arbchar.3       - single match character
  4964.      
  4965.      AUtosave
  4966.           The status of AUTOSAVE and/or the frequency setting.
  4967.           (QEMS)
  4968.      
  4969.           autosave.0      - 1
  4970.           autosave.1      - OFF|n
  4971.      
  4972.      BACKup
  4973.           Indicates if a .bak file is kept after editing.
  4974.           (QEMS)
  4975.      
  4976.           backup.0        - 1
  4977.           backup.1        - ON|OFF|TEMP|KEEP
  4978.      
  4979.      BEEP
  4980.           Indicates if the bell is sounded on display of error messages.
  4981.           (QEMS)
  4982.      
  4983.           beep.0          - 1
  4984.           beep.1          - ON|OFF
  4985.      
  4986.      BLOCK
  4987.           Returns information about the marked block, if any.
  4988.           (E)
  4989.      
  4990.           block.0         - 6 if a marked block exists, or 1 for NONE
  4991.           block.1         - type of marked block (LINE|BOX|NONE|WORD|COLUMN)
  4992.           block.2         - line number of start of block
  4993.           block.3         - column number of start of block
  4994.           block.4         - line number of end of block
  4995.           block.5         - column number of end of block
  4996.           block.6         - file name containing marked block
  4997.      
  4998.      CASE
  4999.           The settings related to the CASE of characters entered, searched
  5000.           for, changed and sorted.
  5001.           (QEMS)
  5002.      
  5003.           case.0          - 4
  5004.           case.1          - MIXED|UPPER|LOWER
  5005.           case.2          - RESPECT|IGNORE
  5006.           case.3          - RESPECT|IGNORE
  5007.           case.4          - RESPECT|IGNORE
  5008.      
  5009.      CLEARScreen
  5010.           Indicates if the screen is cleared on exit from THE.
  5011.           (QEMS)
  5012.      
  5013.           clearscreen.0   - 1
  5014.           clearscreen.1   - ON|OFF
  5015.      
  5016.      CLOCK
  5017.           Indicates if the time is displayed on the status line.
  5018.           (QEMS)
  5019.      
  5020.           clock.0         - 1
  5021.           clock.1         - ON|OFF
  5022.      
  5023.      CMDArrows
  5024.           Returns the settings for arrow key behaviour.
  5025.           (QEMS)
  5026.      
  5027.           cmdarrows.0     - 1
  5028.           cmdarrows.1     - RETRIEVE|TAB
  5029.      
  5030.      CMDline
  5031.           The settings for the command line.
  5032.           (QEMS)
  5033.      
  5034.           If CMDLINE OFF
  5035.      
  5036.           cmdline.0       - 1
  5037.           cmdline.1       - OFF
  5038.      
  5039.           If CMDLINE ON, BOTTOM or TOP
  5040.      
  5041.           cmdline.0       - 3
  5042.           cmdline.1       - ON|TOP|BOTTOM
  5043.           cmdline.2 *     - line number within window of command line
  5044.           cmdline.3 *     - contents of command line
  5045.                     * these values are only returned with EXTRACT
  5046.      
  5047.      COMPAT
  5048.           The settings for the compatibility mode.
  5049.           (QEMS)
  5050.      
  5051.           compat.0        - 1
  5052.           compat.1        - THE|XEDIT|KEDIT
  5053.      
  5054.      CURline
  5055.           The value and position of the current line within the current file.
  5056.           (QEMS)
  5057.      
  5058.           With EXTract command:
  5059.      
  5060.           curline.0       - 3
  5061.           curline.1       - curline setting
  5062.           curline.2       - line number within window of current line
  5063.           curline.3       - contents of current line
  5064.      
  5065.           With Query,Modify and Status commands:
  5066.      
  5067.           curline.0       - 1
  5068.           curline.1       - curline setting
  5069.      
  5070.      CURSor
  5071.           The position of the cursor within the displayed screen and file
  5072.           at the time the EXTRACT /CURSOR/ is issued and the position of
  5073.           the cursor at the time the macro was issued.
  5074.           If the cursor is not in the file area, then line and column
  5075.           values will be set to -1.
  5076.           (QE)
  5077.      
  5078.           cursor.0        - 8
  5079.           cursor.1        - line number of cursor in screen (current)
  5080.           cursor.2        - column number of cursor in screen (current)
  5081.           cursor.3        - line number of cursor in file (current)
  5082.           cursor.4        - column number of cursor in file (current)
  5083.           cursor.5        - line number of cursor in screen (original)
  5084.           cursor.6        - column number of cursor in screen (original)
  5085.           cursor.7        - line number of cursor in file (original)
  5086.           cursor.8        - column number of cursor in file (original)
  5087.      
  5088.      DIRFILEID
  5089.           The value of the path and filename of the focus line in a DIR.DIR
  5090.           file.
  5091.           (E)
  5092.      
  5093.           dirfileid.0     - 2
  5094.           dirfileid.1     - full path of directory
  5095.           dirfileid.2     - file name at focus line
  5096.      
  5097.      DISPlay
  5098.           Indicates the range of selection levels current.
  5099.           (QEMS)
  5100.      
  5101.           display.0       - 2
  5102.           display.1       - display low value
  5103.           display.2       - display high value
  5104.      
  5105.      EOF
  5106.           Indicates if the current line is on the *** Bottom of file *** line.
  5107.           (QES)
  5108.      
  5109.           eof.0           - 1
  5110.           eof.1           - ON|OFF
  5111.      
  5112.      EOLout
  5113.           Returns the value of the end-of-line character(s).
  5114.           (QEMS)
  5115.      
  5116.           eolout.0        - 1
  5117.           eolout.1        - LF|CRLF
  5118.      
  5119.      ETMODE
  5120.           Indicates if extended display mode is set.
  5121.           (QEMS)
  5122.      
  5123.           etmode.0        - 1
  5124.           etmode.1        - ON|OFF
  5125.      
  5126.      FNAME
  5127.           The file name of the current file.
  5128.           (E)
  5129.      
  5130.           fname.0         - 1
  5131.           fname.1         - File name.
  5132.      
  5133.      FPATH
  5134.           The path name of the current file. This includes a trailing
  5135.           directory separator.
  5136.           (E)
  5137.      
  5138.           fpath.0         - 1
  5139.           fpath.1         - File path.
  5140.      
  5141.      FTYPE
  5142.           The extension of the current file. The characters following
  5143.           the trailing '.' character.
  5144.           (E)
  5145.      
  5146.           ftype.0         - 1
  5147.           ftype.1         - File extension.
  5148.      
  5149.      GETENV variable
  5150.           The value of the supplied environment variable or ***invalid***
  5151.           if the variable does not exist.
  5152.           (E)
  5153.      
  5154.           getenv.0        - 1
  5155.           getenv.1        - value of variable
  5156.      
  5157.      HEX
  5158.           Indicates if HEX is on or off.
  5159.           (QEMS)
  5160.      
  5161.           hex.0           - 1
  5162.           hex.1           - ON|OFF
  5163.      
  5164.      HEXDISPlay
  5165.           Indicates if the current character is displayed on the status line.
  5166.           (QEMS)
  5167.      
  5168.           hexdisplay.0    - 1
  5169.           hexdisplay.1    - ON|OFF
  5170.      
  5171.      HEXShow
  5172.           Returns details of HEXSHOW placement.
  5173.           (QEMS)
  5174.      
  5175.           hexshow.0       - 2
  5176.           hexshow.1       - ON|OFF
  5177.           hexshow.2       - line displaying first hexshow line
  5178.      
  5179.      IDline
  5180.           Indicates if the id line is displayed for a file.
  5181.           (QEMS)
  5182.      
  5183.           idline.0        - 1
  5184.           idline.1        - ON|OFF
  5185.      
  5186.      IMPMACro
  5187.           Indicates if implied macro processing is on or off.
  5188.           (QEMS)
  5189.      
  5190.           impmacro.0      - 1
  5191.           impmacro.1      - ON|OFF
  5192.      
  5193.      IMPOS
  5194.           Indicates if implied operating system command processing is on 
  5195.           or off.
  5196.           (QEMS)
  5197.      
  5198.           impos.0         - 1
  5199.           impos.1         - ON|OFF
  5200.      
  5201.      INSERTmode
  5202.           Indicates if currently in insert mode or overstrike mode.
  5203.           (QEMS)
  5204.      
  5205.           insertmode.1    - 1
  5206.           insertmode.1    - ON|OFF
  5207.      
  5208.      LASTmsg
  5209.           Return the text of the last error message generated.
  5210.           (E)
  5211.      
  5212.           lastmsg.0       - 1
  5213.           lastmsg.1       - text of last message.
  5214.      
  5215.      LASTRC
  5216.           Return code from last command issued from command line.
  5217.           (QES)
  5218.      
  5219.           lastrc.0        - 1
  5220.           lastrc.1        - Last return code.
  5221.      
  5222.      LENgth
  5223.           Length of the current line.
  5224.           (QES)
  5225.      
  5226.           length.0        - 1
  5227.           length.1        - Length of current line.
  5228.      
  5229.      LIne
  5230.           Line number of current line in current file.
  5231.           (QES)
  5232.      
  5233.           line.0          - 1
  5234.           line.1          - Line number
  5235.      
  5236.      LINENd
  5237.           Indicates if multiple commands allowed on command line
  5238.           and the delimiter.
  5239.           (QEMS)
  5240.      
  5241.           linend.0        - 2
  5242.           linend.1        - ON|OFF
  5243.           linend.2        - delimiter
  5244.      
  5245.      MACROExt
  5246.           The current setting for a macro's file extension.
  5247.           (QEMS)
  5248.      
  5249.           macroext.0      - 1
  5250.           macroext.1      - Default file extension
  5251.      
  5252.      MACROPath
  5253.           The path that THE looks for by default for macro files.
  5254.           (QEMS)
  5255.      
  5256.           macropath.0     - 1
  5257.           macropath.1     - Path for macro files.
  5258.      
  5259.      MARgins
  5260.           The settings for left and right margins and paragraph indent.
  5261.           (QEMS)
  5262.      
  5263.           margins.0       - 3
  5264.           margins.1       - left column
  5265.           margins.2       - right column
  5266.           margins.3       - indent value (column or offset from left margin)
  5267.      
  5268.      MONITOR
  5269.           Indicates if the combination of monitor and the curses package
  5270.           supports colour. If the curses package supports colour, then
  5271.           monitor.3 is set to COLOR and monitor.2 can be COLOR or MONO
  5272.           depending on whether the monitor supports colour. If monitor.3
  5273.           is MONO then monitor.2 will also be set to MONO.
  5274.           (QES)
  5275.      
  5276.           monitor.0       - 2
  5277.           monitor.1       - COLOR|MONO
  5278.           monitor.2       - COLOR|MONO
  5279.      
  5280.      MSGLine
  5281.           Returns details of where the message line is displayed.
  5282.           (QEMS)
  5283.      
  5284.           msgline.0       - 2
  5285.           msgline.1       - ON
  5286.           msgline.2       - line position of message line
  5287.           msgline.3       - number of message lines available
  5288.           msgline.4       - OVERLAY
  5289.      
  5290.      MSGMode
  5291.           Indicates if MSGMODE setting is on or off.
  5292.           (QEMS)
  5293.      
  5294.           msgmode.0       - 1
  5295.           msgmode.1       - ON|OFF
  5296.      
  5297.      NBFile
  5298.           Returns with the number of files currently in the ring.
  5299.           (QES)
  5300.      
  5301.           nbfile.0        - 1
  5302.           nbfile.1        - Number of files in ring
  5303.      
  5304.      NEWLines
  5305.           Indicates if NEWLINES variable is set to LEFT or ALIGNED.
  5306.           (QEMS)
  5307.      
  5308.           newlines.0      - 1
  5309.           newlines.1      - ALIGNED|LEFT
  5310.      
  5311.      NONDisp
  5312.           Returns the character that is displayed for extended characters
  5313.           that are not displayed.
  5314.           (QEMS)
  5315.      
  5316.           nondisp.0       - 1
  5317.           nondisp.1       - char
  5318.      
  5319.      NUMber
  5320.           Indicates if line numbers are displayed in the prefix area.
  5321.           (QEMS)
  5322.      
  5323.           number.0        - 1
  5324.           number.1        - ON|OFF
  5325.      
  5326.      PENDing [BLOCK] [OLDNAME] name|*
  5327.           Returns information about pening prefix commands.
  5328.           (E)
  5329.      
  5330.           pending.0       - 4
  5331.           pending.1       - line number in file
  5332.           pending.2       - newname - actual name entered in prefix area
  5333.           pending.3       - oldname - original name of macro after
  5334.                                       synonym resolution
  5335.           pending.4       - BLOCK or null
  5336.      
  5337.      Point [*]
  5338.           Returns the name and line number of the focus line, or names and
  5339.           line numbers of all lines in a file if '*' is specified.
  5340.           (QEMS)
  5341.      
  5342.           When 'EXTract /Point' is specified:
  5343.      
  5344.           point.0         - 0 or 1       (0 if focus line not named)
  5345.           point.1         - line number and name of line (if line is named)
  5346.      
  5347.           When 'EXTract /Point *' is specified:
  5348.           (E)
  5349.      
  5350.           point.0         - number of named lines in the file
  5351.           point.1         - line number and name for first named line
  5352.           point.n         - line number and name for nth named line
  5353.      
  5354.      POSition
  5355.           Indicates if LINE/COL is displayed on IDLINE
  5356.           (QEMS)
  5357.      
  5358.           position.0      - 3
  5359.           position.1      - ON|OFF
  5360.           position.2      - current or focus line
  5361.           position.3      - current or focus column
  5362.      
  5363.      PREfix [Synonym name|*]
  5364.           Indicates if prefix is displayed for the view and if displayed
  5365.           where is is displayed.
  5366.           (QEMS)
  5367.      
  5368.           prefix.0        - 1 or 2     (1 if prefix.1 is OFF, 2 otherwise)
  5369.           prefix.1        - ON|OFF|NULLS
  5370.           prefix.2        - LEFT|RIGHT        (if prefix.1 is ON or NULLS)
  5371.      
  5372.           With [Synonym name] option, the name of the macrofile (oldname) 
  5373.           is returned that is associated with the synonym, name. If name 
  5374.           is not a synonym then name is returned.
  5375.           (E)
  5376.      
  5377.           prefix.0        - 1
  5378.           prefix.1        - oldname
  5379.      
  5380.           With [Synonym *] option, all prefix synonyms are returned.
  5381.           (E)
  5382.      
  5383.           prefix.0        - number of prefix synonyms
  5384.           prefix.1        - newname oldname
  5385.           prefix.n        - newname oldname
  5386.      
  5387.      PRINTER
  5388.           Returns the value of the printer port or spooler.
  5389.           (QEMS)
  5390.      
  5391.           printer.0       - 1
  5392.           printer.1       - port or spooler name
  5393.      
  5394.      REPROFile
  5395.           Indicates if the profile file is to be re-executed for each
  5396.           subsequent file to be edited.
  5397.           (QEMS)
  5398.      
  5399.           reprofile.0     - 1
  5400.           reprofile.1     - ON|OFF
  5401.      
  5402.      REESERved
  5403.           Return with list of the screen rows that have been reserved.
  5404.           (QES)
  5405.      
  5406.           reserved.0      - 0 if no reserved lines; 1 otherwise
  5407.           reserved.1      - list of screen row numbers reserved
  5408.      
  5409.      REXXOUTput
  5410.           Indicates if REXX output is captured to a file or not and the
  5411.           line number limit of lines to be displayed.
  5412.           (QEMS)
  5413.      
  5414.           rexxoutput.0    - 2
  5415.           rexxoutput.1    - FILE|DISPLAY
  5416.           rexxoutput.2    - line number limit
  5417.      
  5418.      SCOPE
  5419.           Returns the status of [SET] SCOPE.
  5420.           (QEMS)
  5421.      
  5422.           scope.0         - 1
  5423.           scope.1         - ALL|DISPLAY
  5424.      
  5425.      SCALe
  5426.           Returns details of SCALE line.
  5427.           (QEMS)
  5428.      
  5429.           scale.0         - 2
  5430.           scale.1         - ON|OFF
  5431.           scale.2         - line displaying scale line
  5432.      
  5433.      SELect
  5434.           Returns the selection level of the focus line and the
  5435.           maximum selection level for the file.
  5436.           (QES)
  5437.      
  5438.           select.0        - 2
  5439.           select.1        - selection level of focus line
  5440.           select.2        - maximum selection level for file
  5441.      
  5442.      SHADow
  5443.           Returns the status of the display of shadow lines.
  5444.           (QEMS)
  5445.      
  5446.           shadow.0        - 1
  5447.           shadow.1        - ON|OFF
  5448.      
  5449.      SIze
  5450.           Returns the number of lines in the current file.
  5451.           (QES)
  5452.      
  5453.           size.0          - 1
  5454.           size.1          - Lines in current file.
  5455.      
  5456.      STATUSLine
  5457.           The settings for the status line.
  5458.           (QEMS)
  5459.      
  5460.           statusline.0    - 1
  5461.           statusline.1    - TOP|BOTTOM|OFF
  5462.      
  5463.      STAY
  5464.           Indicates if STAY is on or off.
  5465.           (QEMS)
  5466.      
  5467.           stay.0          - 1
  5468.           stay.1          - ON|OFF
  5469.      
  5470.      TABKey
  5471.           Returns settings about behaviour of TAB key.
  5472.           tabkey.1 is behaviour while in insert mode
  5473.           tabkey.2 is behaviour while not in insert mode
  5474.           (QEMS)
  5475.      
  5476.           tabkey.0        - 2
  5477.           tabkey.1        - TAB|CHARACTER
  5478.           tabkey.2        - TAB|CHARACTER
  5479.      
  5480.      TABLine
  5481.           Returns details of TABLine line.
  5482.           (QEMS)
  5483.      
  5484.           tabline.0       - 2
  5485.           tabline.1       - ON|OFF
  5486.           tabline.2       - line displaying tab line
  5487.      
  5488.      TABS
  5489.           Returns settings about tab columns.
  5490.           (QEMS)
  5491.      
  5492.           tabs.0          - 2
  5493.           tabs.1          - tab columns
  5494.      
  5495.      TABSIn
  5496.           Indicates if TABSIN processing is on or off and the size of the
  5497.           tabs setting.
  5498.           (QEMS)
  5499.      
  5500.           tabsin.0        - 2
  5501.           tabsin.1        - ON|OFF
  5502.           tabsin.2        - size of tabs
  5503.      
  5504.      TABSOut
  5505.           Indicates if TABSOUT processing is on or off and the size of the
  5506.           tabs setting.
  5507.           (QEMS)
  5508.      
  5509.           tabsout.0       - 2
  5510.           tabsout.1       - ON|OFF
  5511.           tabsout.2       - size of tabs
  5512.      
  5513.      TERMinal
  5514.           Identifies the terminal type currently being used.
  5515.           (QES)
  5516.      
  5517.           terminal.0      - 1
  5518.           terminal.1      - DOS|OS2|$TERM value under Unix
  5519.      
  5520.      TOF
  5521.           Indicates if the current line is on the *** Top of file *** line.
  5522.           (QES)
  5523.      
  5524.           tof.0           - 1
  5525.           tof.1           - ON|OFF
  5526.      
  5527.      Verify
  5528.           Returns verify column settings.
  5529.           (QEMS)
  5530.      
  5531.           verify.0        - 1
  5532.           verify.1        - Column pair of verify start and end columns.
  5533.      
  5534.      VERShift
  5535.           Returns vertical shift value.
  5536.           (QES)
  5537.      
  5538.           vershift.0      - 1
  5539.           vershift.1      - VERSHIFT value
  5540.      
  5541.      VERSION
  5542.           Returns information about name of application (THE) and version
  5543.           information.
  5544.           (QES)
  5545.      
  5546.           version.0       - 4
  5547.           version.1       - THE
  5548.           version.2       - version string eg. 1.5
  5549.           version.3       - platform version (DOS,OS2,UNIX)
  5550.           version.4       - version status information eg. beta
  5551.      
  5552.      Width
  5553.           Returns maximum line width setting.
  5554.           (QES)
  5555.      
  5556.           width.0         - 1
  5557.           width.1         - Maximum line width value.
  5558.      
  5559.      WORDWrap
  5560.           Indicates if WORDWARP is on or off.
  5561.           (QEMS)
  5562.      
  5563.           wordwrap.0      - 1
  5564.           wordwrap.1      - ON|OFF
  5565.      
  5566.      Zone
  5567.           Returns zone column settings.
  5568.           (QEMS)
  5569.      
  5570.           zone.0          - 2
  5571.           zone.1          - Zone start column
  5572.           zone.2          - Zone end column
  5573.      
  5574.      
  5575.      
  5576.      ========================================================================
  5577.      IMPLIED EXTRACT, BOOLEAN and OTHER FUNCTIONS
  5578.      ========================================================================
  5579.      
  5580.      IMPLIED EXTRACT
  5581.      
  5582.           The above REXX variables set above by the EXTRACT command may also
  5583.           be obtained by a REXX macro as an implied EXTRACT. Each variable
  5584.           above that may be set by an explicit EXTRACT command may also be
  5585.           used as an external function to REXX to obtain the same information.
  5586.           eg. The REXX commands:
  5587.      
  5588.               'EXTRACT /SIZE/CURLINE/'
  5589.               Say size.1 curline.1
  5590.      
  5591.           may be substituted with:
  5592.      
  5593.               Say size.1() curline.1()
  5594.      
  5595.      BOOLEAN FUNCTIONS
  5596.      
  5597.           THE also provides other information to the REXX interpreter via
  5598.           boolean functions. These functions return either '1' or '0'
  5599.           depending on the information queried.
  5600.      
  5601.        after()
  5602.           Returns '1' if the cursor is currently after the last non-blank
  5603.           character on the line, or if the line is blank.
  5604.      
  5605.        blank()
  5606.           Returns '1' if the line the cursor is on is completely blank.
  5607.      
  5608.        block()
  5609.           Returns '1' if the marked block is within the current view.
  5610.      
  5611.        before()
  5612.           Returns '1' if the cursor is currently before the first non-blank
  5613.           character on the line, or if the line is blank.
  5614.      
  5615.        bottomedge()
  5616.           Returns '1' if the cursor is on the bottom edge of the filearea
  5617.           or prefix area.
  5618.      
  5619.        command()
  5620.           Returns '1' if the command line is on. This is different to
  5621.           KEDIT's definition; "Returns '1' if the cursor is on the 
  5622.           command line." To get the equivalent KEDIT functionality
  5623.           use incommand();
  5624.      
  5625.        current()
  5626.           Returns '1' if the cursor is on the current line.
  5627.      
  5628.        dir()
  5629.           Returns '1' if the current file is the special DIR.DIR file.
  5630.      
  5631.        end()
  5632.           Returns '1' if the cursor is on the last non-blank character on
  5633.           the line.
  5634.      
  5635.        eof()
  5636.           Returns '1' if the cursor is on the '*** Bottom of file ***' line
  5637.           and the cursor is not on the command line.
  5638.      
  5639.        first()
  5640.           Returns '1' if the cursor is in column 1 of the current window.
  5641.      
  5642.        focuseof()
  5643.           Returns '1' if the focus line is the '*** Bottom of file ***' line
  5644.           whether the cursor is on it or not.
  5645.      
  5646.        focustof()
  5647.           Returns '1' if the focus line is the '*** Top of file ***' line
  5648.           whether the cursor is on it or not.
  5649.      
  5650.        inblock()
  5651.           Returns '1' if the cursor is in the marked block.
  5652.      
  5653.        incommand()
  5654.           Returns '1' if the cursor is on the command line.
  5655.      
  5656.        initial()
  5657.           Returns '1' if the function is called from the profile file.
  5658.      
  5659.        inprefix()
  5660.           Returns '1' if the cursor is located in the prefix area.
  5661.      
  5662.        leftedge()
  5663.           Returns '1' if the cursor is on the left edge of the file area.
  5664.      
  5665.        modifiable()
  5666.           Returns '1' if the cursor is located in an area that can be changed.
  5667.           ie. not on '*** Top of File ***' or '*** Bottom of File ***' lines.
  5668.      
  5669.        rightedge()
  5670.           Returns '1' if the cursor is on the right edge of the file area.
  5671.      
  5672.        spacechar()
  5673.           Returns '1' if the cursor is on a space character.
  5674.      
  5675.        tof()
  5676.           Returns '1' if the cursor is on the '*** Top of file ***' line
  5677.           and the cursor is not on the command line.
  5678.      
  5679.        topedge()
  5680.           Returns '1' if the cursor is on the top edge of the file area.
  5681.      
  5682.        verone()
  5683.           Returns '1' if the column 1 of the file is being displayed in
  5684.           column 1.
  5685.      
  5686.      OTHER FUNCTIONS
  5687.      
  5688.         The following functions provide features to simplify THE macros
  5689.         written in REXX.
  5690.      
  5691.        valid_target(target[,anything])
  5692.           Returns 'ERROR' if the supplied target is invalid.
  5693.           Returns 'NOTFOUND' if the supplied target is valid, but not found.
  5694.      
  5695.           The first argument is the target to be validated. If a second,
  5696.           optional argument is supplied, the target to be validated can
  5697.           consist of a target followed by any optional characters. This can
  5698.           be useful if the arguments to a macro consist of a target followed
  5699.           by another argument. If a valid target is supplied, the remainder
  5700.           of the string passed to valid_target() is returned following the
  5701.           first line affected and the number of lines to the target.
  5702.      
  5703.           If a valid target, returns the first line affected by the target
  5704.           followed by the number of lines to the target, and optionally the
  5705.           remainder of the argument.
  5706.           eg. if the focus line is 12 and valid_target() is called as
  5707.               result = valid_target(":7") , the return value is "12 -5"
  5708.               if the focus line is 12 and valid_target is called as
  5709.               result = valid_target(":7 /fred bloggs/",junk), the return
  5710.               value is "12 -5 /fred bloggs/"
  5711.      
  5712.  
  5713.  
  5714.  
  5715.      --------------------------------------------------------------------------
  5716.      
  5717.      
  5718.      ========================================================================
  5719.      APPENDIX 1 - ENVIRONMENT VARIABLES
  5720.      ========================================================================
  5721.      
  5722.      THE uses the following environment variables:
  5723.      
  5724.              THE_HOME_DIR     - the directory in which THE looks for its help
  5725.                                 file(s) and macro(s);
  5726.              THE_HELP_FILE    - the fully qualified file name containing help
  5727.                                 information.
  5728.              THE_PROFILE_FILE - the fully qualified file name for the default
  5729.                                 profile file.
  5730.              THE_MACRO_PATH   - a list of all directories in which THE is to 
  5731.                                 look for macro files.
  5732.      
  5733.      The following defines how these environment variables are used under UNIX.
  5734.      
  5735.      If no environment variable; THE_HOME_DIR, is set prior to starting THE,
  5736.      THE uses /usr/local/THE/ (or /opt/THE/ if SYSVR4 is defined when compiling)
  5737.      as the default value for ${THE_HOME_DIR}. 
  5738.      This can be changed in the.c if necessary.
  5739.      
  5740.      The default value of THE_HELP_FILE is ${THE_HOME_DIR}${TERM}.hlp
  5741.      eg. with no environment variables set and $TERM set to vt220, the help 
  5742.      file to be looked for will be /usr/local/THE/vt220.hlp (or 
  5743.      /opt/THE/vt220.hlp if SYSVR4 is defined when compiling).
  5744.      If THE_HOME_DIR environment variable was set to /usr/opt/etc or changed in
  5745.      the.c, the help file will be /usr/opt/etc/vt220.hlp. If no $TERM 
  5746.      environment variable is set, "default" is used.
  5747.      
  5748.      The name of the default profile file is $HOME/.therc.
  5749.      
  5750.      The default value of THE_MACRO_PATH is ${THE_HOME_DIR}:. THE will look for 
  5751.      a macro file first in ${THE_HOME_DIR} and then in the current directory. 
  5752.      So with no environment variables set, THE looks for macros in 
  5753.      $(THE_HOME_DIR} first and if no file exists in that directory, THE will 
  5754.      look in the current directory. If the file does not exist in either of 
  5755.      these places, an error message will be displayed.
  5756.      The format of THE_MACRO_PATH is dir1:dir2:dir3 Each directory is seperated 
  5757.      by colons. By default, up to 20 directories may be specified. This can be 
  5758.      changed in the.h.
  5759.      
  5760.      The following defines how these environment variables are used under DOS 
  5761.      and OS/2.
  5762.      
  5763.      By default THE_HOME_DIR is set to the directory from which THE was 
  5764.      invoked. Assuming THE.EXE resides in d:\tools, THE_HOME_DIR will equate 
  5765.      to d:\tools\.
  5766.      
  5767.      The default value of THE_HELP_FILE is ${THE_HOME_DIR}dos.hlp for DOS and
  5768.      ${THE_HOME_DIR}os2.hlp for OS/2.
  5769.      
  5770.      The name of the default profile file is ${THE_HOME_DIR}profile.the.
  5771.      
  5772.      The default value of THE_MACRO_PATH is ${THE_HOME_DIR};. THE will look for
  5773.      a macro file first in THE_HOME_DIR and then in the current directory. So 
  5774.      with no environment variables set, THE first looks for macros in the 
  5775.      directory from which THE was invoked and then in the current directory. 
  5776.      If the file does not exist in either directory, an error message is displayed.
  5777.      The format of THE_MACRO_PATH is dir1;dir2;dir3 Each directory is seperated 
  5778.      by semi-colons. By default up to 20 directories may be specified. This can 
  5779.      be changed in the.h.
  5780.      
  5781.  
  5782.  
  5783.  
  5784.      --------------------------------------------------------------------------
  5785.      
  5786.      
  5787.      ========================================================================
  5788.      GLOSSARY
  5789.      ========================================================================
  5790.      
  5791.           Bottom-of-File line
  5792.                A line marker, identifying the end of the file.
  5793.      
  5794.           command line
  5795.                The area of the display, usually identified by an arrow
  5796.                prompt, "====>", where THE commands are entered.
  5797.      
  5798.           current line
  5799.                The line in the filearea, normally highlighted, from which
  5800.                commands entered on the command line take effect.
  5801.      
  5802.           filearea
  5803.                That part of the screen display where the contents of the
  5804.                file being edited are displayed.
  5805.      
  5806.           focus line
  5807.                The line in the filearea which currently has the focus. If
  5808.                the cursor is in the filearea or prefix area, it is the line
  5809.                on which the cursor is displayed. If the cursor is on the
  5810.                command line, the focus line is the current line. All THE
  5811.                commands operate relative to the focus line.
  5812.      
  5813.           idline
  5814.                That part of the screen display which shows details about
  5815.                the file being edited.
  5816.      
  5817.           macro
  5818.                A file containing a sequence of THE commands. Macros can
  5819.                be written in REXX if a supported REXX interpreter is 
  5820.                available.
  5821.      
  5822.           prefix area
  5823.                That part of the screen display where prefix commands can
  5824.                be entered. It also displays the line number of each line
  5825.                in the file is SET NUMBER is ON.
  5826.      
  5827.           profile
  5828.                A macro file that is executed at the start of an editing
  5829.                session.
  5830.           REXX
  5831.                A powerful, easy-to-learn macro language available on most
  5832.                machines that THE uses as its macro language.
  5833.      
  5834.           ring
  5835.                The set of files currently being edited are arranged in a
  5836.                ring formation.
  5837.      
  5838.           scaleline
  5839.                A line in the filearea showing column positions.
  5840.      
  5841.           shadow line
  5842.                A line which signifies how many lines have been excluded
  5843.                from display. See SET SHADOW, SET SELECT.
  5844.      
  5845.           statusline
  5846.                That part of the screen display showing details about the
  5847.                entire THE session.
  5848.      
  5849.           tabline
  5850.                A line in the filearea which displays the currently set 
  5851.                TAB stops.
  5852.      
  5853.           target
  5854.                A method of referring to some part of the file being edited.
  5855.      
  5856.           Top-of-File line
  5857.                A line marker, identifying the beginning of the file.
  5858.      
  5859.  
  5860.  
  5861.  
  5862.      --------------------------------------------------------------------------
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.